{ "openapi": "3.0.1", "info": { "title": "EU Tariff Quota Balance Monitor", "description": "Track EU tariff quota remaining balances from the European Commission's weekly QUOTA reports. Look up quota order numbers, export published balances, and detect critical, exhausted or reopened quotas between runs. JSON/CSV output for customs and procurement workflows.", "version": "0.1", "x-build-id": "RScxwbBgOewZ4obMd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automa-flow~eu-tariff-quota-balance-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automa-flow-eu-tariff-quota-balance-monitor", "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/automa-flow~eu-tariff-quota-balance-monitor/runs": { "post": { "operationId": "runs-sync-automa-flow-eu-tariff-quota-balance-monitor", "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/automa-flow~eu-tariff-quota-balance-monitor/run-sync": { "post": { "operationId": "run-sync-automa-flow-eu-tariff-quota-balance-monitor", "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": { "quotaOrderNumbers": { "title": "Quota order numbers", "maxItems": 5000, "type": "array", "description": "EU tariff quota order numbers, six ASCII digits (0-9), written either as 090006 or as 09.0006. Leading zeroes matter and are preserved. Unicode lookalikes are invalid and never charged. Duplicates are removed before any work, so a repeated number is never charged twice. One order number can return several rows: the Commission publishes a separate balance per validity period, origin and sub-quota.", "items": { "type": "string" } }, "includeAllCurrent": { "title": "Export every published quota", "type": "boolean", "description": "Return every quota in the Commission's current reports, roughly 1,500 order numbers and 2,300 balances, bounded by maxItems. Order numbers you listed explicitly come first. With change detection on, also check previously monitored numbers for departures. Set a sufficient run charge limit; an account credit limit can restrict a full export.", "default": false }, "detectChanges": { "title": "Detect changes since the last run", "type": "boolean", "description": "Compare each quota against its last successful observation and report FIRST_SEEN, BALANCE_CHANGED, BECAME_CRITICAL, EXHAUSTED, REOPENED and the rest. Turn it off for a one-off lookup without a named monitoring baseline. Output, summary and recovery checkpoint are still stored in the run's default storage.", "default": true }, "emitUnchanged": { "title": "Include unchanged quotas", "type": "boolean", "description": "When off, a run returns only quotas that moved, plus quotas that left the reports. Unchanged quotas are then neither returned nor charged, so a scheduled watch costs only for the movements it finds.", "default": true }, "monitorId": { "title": "Monitor ID", "maxLength": 80, "type": "string", "description": "Names the stored baseline so several watchlists can be monitored independently. Any label up to 80 characters. Leave it empty and the baseline is keyed by the set of order numbers you asked for, which keeps an unattended schedule working without one." }, "maxItems": { "title": "Target maximum rows", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Target maximum number of quota rows. The cut always falls on an order-number boundary, so the first complete order number can exceed this target when it has several periods; a quota is never half-returned.", "default": 2000 } } }, "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 } } } } } } } } } }