{
  "openapi": "3.0.1",
  "info": {
    "title": "Singapore Company Search: ACRA UEN Lookup & New Companies",
    "description": "Singapore company data from ACRA's open data on data.gov.sg: UEN lookup, company name search, and lists of new companies by registration date, SSIC code, status, type or postal code. Address, SSIC, former names, officer count. No API key. Sole proprietors excluded by default. $2.50 per 1,000.",
    "version": "1.0",
    "x-build-id": "uZfcEnLYRoP1lBRk1"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/terracotta_hauyne~singapore-company-data-acra/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-terracotta_hauyne-singapore-company-data-acra",
        "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/terracotta_hauyne~singapore-company-data-acra/runs": {
      "post": {
        "operationId": "runs-sync-terracotta_hauyne-singapore-company-data-acra",
        "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/terracotta_hauyne~singapore-company-data-acra/run-sync": {
      "post": {
        "operationId": "run-sync-terracotta_hauyne-singapore-company-data-acra",
        "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": {
          "uens": {
            "title": "UENs (lookup)",
            "type": "array",
            "description": "Look up entities by Unique Entity Number (UEN), e.g. 197200078R. Spaces and dashes are ignored. Only UENs issued by ACRA (companies, LLPs, LPs, foreign company branches, businesses) are in the source data. Filters below do not apply to lookups, except 'Exclude sole proprietorships'.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search by entity name",
            "type": "array",
            "description": "Find entities whose name contains all these words (whole words, any order, case-insensitive), e.g. 'robotics' or 'logistics holdings'. All 27 ACRA datasets are searched (about 27 API requests per search). The filters below are applied too.",
            "items": {
              "type": "string"
            }
          },
          "entityTypes": {
            "title": "Entity types",
            "type": "array",
            "description": "Only these entity types. Empty = all (sole proprietorships only if 'Exclude sole proprietorships' is off).",
            "items": {
              "type": "string",
              "enum": [
                "Local Company",
                "Foreign Company Branch",
                "Limited Liability Partnership",
                "Limited Partnership",
                "Sole Proprietorship/ Partnership"
              ]
            }
          },
          "liveOnly": {
            "title": "Live entities only",
            "type": "boolean",
            "description": "Only entities with status 'Live Company' or 'Live' (registered businesses). Added to 'Entity statuses' if both are set.",
            "default": false
          },
          "entityStatuses": {
            "title": "Entity statuses",
            "type": "array",
            "description": "Only entities with one of these exact ACRA statuses.",
            "items": {
              "type": "string",
              "enum": [
                "Live Company",
                "Live",
                "Struck Off",
                "Gazetted To Be Struck Off",
                "Struck Off (Early Dissolution)",
                "Cancelled",
                "Cancelled (Non-Renewal)",
                "Cancellation In Progress",
                "Ceased Registration",
                "Terminated",
                "Registration expired and has not been renewed",
                "Amalgamated",
                "Converted To LLP",
                "In Liquidation",
                "In Liquidation - Members voluntary winding up",
                "In Liquidation - Creditors voluntary winding up",
                "In Liquidation - Compulsory Winding Up",
                "In Liquidation - Compulsory Winding Up (Insolvency)",
                "In Liquidation - Simplified Winding Up",
                "Dissolved - Members Voluntary Winding Up",
                "Dissolved - Creditors Voluntary Winding Up",
                "Dissolved - Compulsory Winding Up",
                "Dissolved - Compulsory Winding Up (Insolvency)",
                "Dissolved - Pursuant to Section 212(1)(D) Of The Companies Act",
                "Removed (Applied To Be Revoked)",
                "Removed (Dissolved)"
              ]
            }
          },
          "registeredFrom": {
            "title": "Registered / incorporated from",
            "type": "string",
            "description": "Registration or incorporation date on or after this date (YYYY-MM-DD). The source is updated monthly by ACRA, so the latest weeks may be missing. Each year in the range costs about 27 API requests."
          },
          "registeredTo": {
            "title": "Registered / incorporated to",
            "type": "string",
            "description": "On or before this date (YYYY-MM-DD). Default: today."
          },
          "ssicCodes": {
            "title": "Primary SSIC codes",
            "type": "array",
            "description": "5-digit Singapore Standard Industrial Classification codes of the primary activity, e.g. 62011 (software development), 56111 (restaurants), 64202 (investment holding).",
            "items": {
              "type": "string"
            }
          },
          "postalCodes": {
            "title": "Postal codes",
            "type": "array",
            "description": "Exact 6-digit Singapore postal codes of the registered address, e.g. 018989.",
            "items": {
              "type": "string"
            }
          },
          "streetName": {
            "title": "Street name contains",
            "type": "string",
            "description": "Words in the registered street name, e.g. 'ang mo kio' or 'cecil street'."
          },
          "excludeSoleProprietorships": {
            "title": "Exclude sole proprietorships / partnerships",
            "type": "boolean",
            "description": "On by default (personal-data minimisation). Sole proprietorships and partnerships are often named after their owners, and the Singapore Open Data Licence grants no rights over personal data. Turn off only if you have a lawful purpose; those items are marked containsPersonalData = true.",
            "default": true
          },
          "sortBy": {
            "title": "Sort search results",
            "enum": [
              "newest",
              "oldest",
              "name"
            ],
            "type": "string",
            "description": "Order of search results across all 27 datasets. With a date range longer than one year, results are sorted within each year.",
            "default": "newest"
          },
          "maxResults": {
            "title": "Max entities in total",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many entities (each entity is one result). 0 = no limit other than your maximum cost per run.",
            "default": 100
          },
          "apiKey": {
            "title": "data.gov.sg API key (optional)",
            "type": "string",
            "description": "Optional. Without a key the actor uses the public rate limit (4 requests per 10 seconds; the actor makes 3), which is fine for lookups and searches up to a few thousand results. A free key from data.gov.sg (sign in → API keys) raises the limit to 8 (development) or 20 (production) requests per 10 seconds. The key is stored encrypted and sent only to data.gov.sg."
          },
          "requestsPerTenSeconds": {
            "title": "Max API requests per 10 seconds",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Pacing. Default 3 without a key, 7 with a key. Set up to 20 only with a production key."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}