{
"openapi": "3.0.1",
"info": {
"title": "Panama RUC Scraper — DGI Company Registry & E-Invoicing Status",
"description": "Consulta RUC Panamá in bulk: look up Panamanian companies by RUC or name in the DGI's public e-invoicing registry — legal name, RUC, affiliation and issuing status, invoicing mode, affiliation date, commercial activity. JSON, CSV or Excel.",
"version": "0.0",
"x-build-id": "aY9tTNIcJ0eBLDGyC"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/registralia~panama-ruc-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-registralia-panama-ruc-scraper",
"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/registralia~panama-ruc-scraper/runs": {
"post": {
"operationId": "runs-sync-registralia-panama-ruc-scraper",
"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/registralia~panama-ruc-scraper/run-sync": {
"post": {
"operationId": "run-sync-registralia-panama-ruc-scraper",
"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": [
"queries"
],
"properties": {
"queries": {
"title": "RUC numbers or company names",
"type": "array",
"description": "One entry per line: a Panamanian RUC (e.g. 280-134-61098 or 8-222-2782) for an exact match, or a company name (e.g. Banco General) for a name search. RUCs and names can be mixed.",
"items": {
"type": "string"
}
},
"maxResultsPerName": {
"title": "Max results per name search",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "A name search can match many registrants (10 per registry page). Stop after this many records per name. RUC searches always return the exact match only.",
"default": 50
},
"checkDelinquentList": {
"title": "Check the DGI list of tax delinquents",
"type": "boolean",
"description": "Downloads the DGI Listado de Morosos (taxpayers with arrears older than 12 months) once per run and adds onDgiDelinquentList, dgiDelinquentTotalUsd and the per-tax breakdown to every RUC-bearing record. Adds roughly 10–20 seconds to the run.",
"default": true
},
"checkRegistroPublico": {
"title": "Check the Registro Público for suspended or dissolved folios",
"type": "boolean",
"description": "Queries the Registro Público de Panamá's public Folios Suspendidos service for every RUC and adds rpFolioStatus (suspended, dissolved, merged, operations_closed or none) with folio, dates and the name the registry holds. One extra request per RUC.",
"default": true
},
"registroPublicoProxyCountry": {
"title": "Registro Público proxy country",
"type": "string",
"description": "The Registro Público API answers Panamanian IPs only, so lookups are routed through an Apify residential proxy in this country. Leave empty to connect directly (cheaper, but only works if the Actor's own IP is accepted).",
"default": "PA"
},
"includeRaw": {
"title": "Include raw row",
"type": "boolean",
"description": "Attach the untouched registry row (Spanish labels) under a `raw` field, for auditing.",
"default": false
},
"maxConcurrency": {
"title": "Parallel lookups",
"minimum": 1,
"maximum": 5,
"type": "integer",
"description": "How many queries to run at once. The DGI site is a public service — keep this low.",
"default": 3
},
"requestTimeoutSecs": {
"title": "Request timeout (seconds)",
"minimum": 5,
"maximum": 120,
"type": "integer",
"description": "How long to wait for the registry to answer one request before giving up and retrying.",
"default": 30
},
"maxRetries": {
"title": "Retries per request",
"minimum": 0,
"maximum": 6,
"type": "integer",
"description": "How often to retry a request after rate limiting or a server error, with exponential backoff.",
"default": 3
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Optional. Only needed if the registry rate-limits the datacenter IP.",
"default": {
"useApifyProxy": false
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}