getstarted.ae

List business entities

GEThttps://api.getstarted.ae/v1/customers/{customerId}/business-entities

Lists business entities under a customer, both ones you created and ones formed through GetStarted.

Path parameters

  • customerIdstringrequired

    ID of the customer, e.g. cus_01J9ZK4R7Q2M8X.

Query parameters

  • limitinteger

    Page size, 1 to 100. Defaults to 25.

  • cursorstring

    The nextCursor value from the previous page.

Responses

  • 200OK. Returns the object shown in the example.
  • 404resource_not_found No customer with that ID exists in this environment.
  • Every endpoint can also return 401 for a missing or invalid key. See Errors.
curl -X GET "https://api.getstarted.ae/v1/customers/cus_01J9ZK4R7Q2M8X/business-entities" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY"
Response · 200
{
  "object": "list",
  "data": [
    {
      "id": "ent_01J9ZKC5TR8F4K",
      "object": "business_entity",
      "customerId": "cus_01J9ZK4R7Q2M8X",
      "legalName": "Northwind Holdings Ltd",
      "entityType": "PRIVATE_LIMITED_COMPANY",
      "countryOfIncorporation": "GB",
      "registrationNumber": "14820391",
      "dateOfIncorporation": "2023-02-09",
      "email": "legal@northwindlabs.com",
      "createdAt": "2026-09-20T08:22:40Z",
      "updatedAt": "2026-09-20T08:22:40Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}