{ "openapi": "3.0.1", "info": { "title": "Uk Waste Carriers Register", "description": "Monitor the Environment Agency's official Waste Carriers, Brokers & Dealers register (England). Track NEW, EXPIRING and LAPSED registrations, or search by name, postcode or CBDU number. Trigger data and supplier verification for equipment suppliers, insurers, compliance and B2B prospecting.", "version": "0.1", "x-build-id": "dmvtSpNCeAezQ9RQ1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/devon_gtme~uk-waste-carriers-register/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-devon_gtme-uk-waste-carriers-register", "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/devon_gtme~uk-waste-carriers-register/runs": { "post": { "operationId": "runs-sync-devon_gtme-uk-waste-carriers-register", "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/devon_gtme~uk-waste-carriers-register/run-sync": { "post": { "operationId": "run-sync-devon_gtme-uk-waste-carriers-register", "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": { "mode": { "title": "Mode", "enum": [ "newRegistrations", "expiringSoon", "recentlyLapsed", "search" ], "type": "string", "description": "What to fetch. **New registrations** = registered in the last N days (new-business trigger). **Expiring soon** = upper-tier registrations whose expiry date falls within the next N days (renewal/compliance leads). **Recently lapsed** = expiry date passed within the last N days and not visibly renewed. **Search register** = query by name / address / registration number (verification & prospecting).", "default": "newRegistrations" }, "daysBack": { "title": "Days Back", "minimum": 1, "maximum": 365, "type": "integer", "description": "New registrations mode: fetch registrations dated within the last N days. Recently lapsed mode: fetch registrations that expired within the last N days. Ignored in other modes.", "default": 7 }, "expiringWithinDays": { "title": "Expiring Within (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Expiring soon mode: fetch registrations whose expiry date falls within the next N days. Ignored in other modes.", "default": 60 }, "nameSearch": { "title": "Name Search", "type": "string", "description": "Full or partial business/person name (e.g. \"skip hire\"). Words are prefix-matched; use *word to match inside a word. Main filter in Search mode; also narrows the date-window modes." }, "addressSearch": { "title": "Address Search", "type": "string", "description": "Full or partial address — postcode (\"SW9\" or \"SW9 0AD\"), town, or street (e.g. \"station road birmingham\"). Works in every mode." }, "numberSearch": { "title": "Registration Number Search", "type": "string", "description": "Full or partial registration number, e.g. \"CBDU128084\" or \"CBDU\". Use this to verify whether a company is legally registered to carry waste. Search mode only." }, "regime": { "title": "Tier / Registration Type", "enum": [ "any", "upper-tier", "lower-tier", "carrier-broker-dealer", "carrier-dealer", "broker-dealer" ], "type": "string", "description": "Filter by tier and registration type. Upper tier = businesses carrying other people's waste professionally (3-year renewable registrations). Lower tier = carrying own waste / exempt bodies (never expires).", "default": "any" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Maximum records to return.", "default": 1000 } } }, "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 } } } } } } } } } }