{ "openapi": "3.0.1", "info": { "title": "IBAN & EU VAT Validator: VIES, Peppol, Invoice Fraud Check", "description": "Validate IBANs and EU VAT numbers (live VIES) and catch bank-change invoice fraud before you pay a supplier. Adds Peppol lookup, invoice VAT maths and SEPA date. ALLOW / REVIEW / BLOCK verdict with reasons, for AP automation and AI payment agents.", "version": "0.3", "x-build-id": "fiIQX0jAIj3qG8YN7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lerider~payee-check/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lerider-payee-check", "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/lerider~payee-check/runs": { "post": { "operationId": "runs-sync-lerider-payee-check", "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/lerider~payee-check/run-sync": { "post": { "operationId": "run-sync-lerider-payee-check", "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", "properties": { "iban": { "title": "IBAN to pay", "type": "string", "description": "Payee-check mode. Leave empty for 'payments' or for supplier pre-flight." }, "payee_name": { "title": "Payee name", "type": "string", "description": "Name on the invoice." }, "amount": { "title": "Amount", "type": "string", "description": "Decimal string, e.g. 1234.56." }, "message_text": { "title": "Invoice / e-mail text", "type": "string", "description": "Text the payment request came with. Used for the IBAN-in-message, amount and pressure-language checks. Not stored by the Actor beyond your run's dataset." }, "known_payees": { "title": "Known payees", "type": "array", "description": "Payees you paid before: [{\"iban\": \"...\", \"name\": \"...\"}]. Enables the new-IBAN-for-known-payee check." }, "payments": { "title": "Batch: payments", "type": "array", "description": "Batch mode: a list of {iban, payee_name, amount, message_text}. 'known_payees' above applies to all. Max 1000." }, "payee": { "title": "Pre-flight: payee", "type": "object", "description": "Supplier pre-flight mode: {\"iban\": \"...\" (required), \"name\": \"...\", \"vat_id\": \"NL...B01\", \"peppol_id\": \"0106:12345678\"}." }, "invoice": { "title": "Pre-flight: invoice", "type": "object", "description": "Optional: {\"text\", \"lines\": [{\"net\": 100.0, \"vat_rate\": 21}], \"total_net\", \"total_vat\", \"total_gross\", \"buyer_vat_id\", \"issue_date\": \"YYYY-MM-DD\"}." }, "pay_on": { "title": "Pre-flight: payment date", "type": "string", "description": "YYYY-MM-DD the payment will be ordered. Default: today (UTC). Used for the SEPA settlement date." }, "preflights": { "title": "Pre-flight batch", "type": "array", "description": "Batch mode: a list of {payee, invoice, pay_on}. 'known_payees' and 'pay_on' above apply to all. Max 200." }, "attest": { "title": "Attest the verdict (event attested-check)", "type": "boolean", "description": "Adds an evidence record to every checked item: the input, verdict, rule version and data_as_of in canonical JSON, its SHA-256, an RFC 3161 timestamp token (FreeTSA) and an OpenTimestamps proof (Bitcoin). Only the hash is sent to the timestamp services. Charged per item only when the timestamp was obtained. Works in both modes.", "default": false }, "verify": { "title": "Verify attestations (free)", "type": "array", "description": "Verify mode: a list of 'attestation' objects (or whole result items) from earlier runs. Checks offline that the record is unchanged and the timestamp token is valid. Not charged. Use on its own, not with a check." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }