{ "openapi": "3.0.1", "info": { "title": "FAA Aircraft Document Index — Lien & Bill of Sale Filings", "description": "Check N-numbers against the FAA Aircraft Registry Document Index: liens (security conveyances), releases, repossessions and bills of sale filed for recordation, with FAA document IDs and receipt dates. Deduplicates the FAA's own 2-3x duplicate entries. Not a title search: ~180-day window.", "version": "0.0", "x-build-id": "YH9lxeQUvDibKwp50" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malekh~faa-aircraft-document-index-lien-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malekh-faa-aircraft-document-index-lien-filings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/malekh~faa-aircraft-document-index-lien-filings/runs": { "post": { "operationId": "runs-sync-malekh-faa-aircraft-document-index-lien-filings", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/malekh~faa-aircraft-document-index-lien-filings/run-sync": { "post": { "operationId": "run-sync-malekh-faa-aircraft-document-index-lien-filings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "aircraft" ], "properties": { "aircraft": { "title": "Aircraft to check (N-numbers)", "type": "array", "description": "One entry per aircraft. Either a plain tail number string (\"N100HY\", \"100hy\" and \"N-100HY\" all work) or an object with nNumber plus your own referenceId, which is echoed back so results reconcile with your loan book or deal file. Up to 2,000 per run." }, "sinceDate": { "title": "Only filings received on or after this date (gap / date-down check)", "type": "string", "description": "ISO date, e.g. 2026-06-01. Use your title report's cutoff date to see only what has been filed since. If your date is earlier than the start of the FAA's current window, the result says so explicitly rather than pretending to cover it — the window is roughly 180 days and moves every working day." }, "documentTypes": { "title": "Only these document types", "type": "array", "description": "Leave empty for all. S/A = security conveyance (lien), REL = lien release, REP = repossession, BOS = evidence of ownership (bill of sale), CSC = evidence of ownership with lien, DIS = disclaimer, CRT = court document. Filtering to S/A + REP is the usual collateral-monitoring setup.", "items": { "type": "string", "enum": [ "S/A", "REL", "REP", "BOS", "CSC", "DIS", "CRT" ], "enumTitles": [ "S/A — Security conveyance (lien)", "REL — Lien release", "REP — Repossession", "BOS — Evidence of ownership (bill of sale)", "CSC — Evidence of ownership with lien", "DIS — Disclaimer", "CRT — Court document" ] } }, "includeRegistration": { "title": "Confirm each N-number against the registration master file", "type": "boolean", "description": "Strongly recommended, and on by default. Without it, a mistyped tail number returns 'no filings' and looks exactly like a clean aircraft. With it, an N-number that is not on the FAA master file comes back status=unverified with the reason. Also fills in owner, make/model, serial and registration status.", "default": true }, "serialNumbers": { "title": "Also search these serial numbers (engine / propeller collateral)", "type": "array", "description": "Optional and exact-match. Engine and propeller liens are indexed against the component's own serial number, not the aircraft's tail number, so they do NOT appear under the N-number. If you know the engine or propeller serials, list them here to catch those filings too.", "items": { "type": "string" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }