getstarted.ae

Retrieve a business entity

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

Returns one business entity.

Path parameters

  • customerIdstringrequired

    ID of the customer, e.g. cus_01J9ZK4R7Q2M8X.

  • idstringrequired

    ID of the business entity, e.g. ent_01J9ZKC5TR8F4K.

Responses

  • 200OK. Returns the object shown in the example.
  • 404resource_not_found No business entity 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/ent_01J9ZKC5TR8F4K" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY"
Response · 200
{
  "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"
}