getstarted.ae

Create a location

POSThttps://api.getstarted.ae/v1/business-entities/{id}/locations

Adds an address to a business entity, such as a registered office or operating address.

Path parameters

  • idstringrequired

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

Body parameters

  • typeenumrequired

    REGISTERED_OFFICE, OPERATING_ADDRESS or MAILING_ADDRESS.

  • addressobjectrequired

    The address.

    • address.line1stringrequired

      Street address.

    • address.line2string

      Unit, floor or building.

    • address.citystringrequired

      City or town.

    • address.regionstring

      State, province or emirate.

    • address.postalCodestring

      Postal or ZIP code. Required where the country uses one.

    • address.countrystringrequired

      ISO 3166-1 alpha-2 country code.

Responses

  • 201Created. Returns the object shown in the example.
  • 400unknown_field The body contains a key the endpoint does not accept.
  • 404resource_not_found No business entity with that ID exists in this environment.
  • 422invalid_value A value fails type or format validation.
  • Every endpoint can also return 401 for a missing or invalid key. See Errors.
curl -X POST "https://api.getstarted.ae/v1/business-entities/ent_01J9ZKC5TR8F4K/locations" \
  -H "Authorization: Bearer $GETSTARTED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "REGISTERED_OFFICE",
  "address": {
    "line1": "18 Robinson Road",
    "line2": "#12-01",
    "city": "Singapore",
    "region": null,
    "postalCode": "048547",
    "country": "SG"
  }
}'
Response · 201
{
  "id": "loc_01J9ZKD2XN9G5H",
  "object": "location",
  "businessEntityId": "ent_01J9ZKC5TR8F4K",
  "type": "REGISTERED_OFFICE",
  "address": {
    "line1": "18 Robinson Road",
    "line2": "#12-01",
    "city": "Singapore",
    "region": null,
    "postalCode": "048547",
    "country": "SG"
  },
  "createdAt": "2026-09-20T08:25:11Z",
  "updatedAt": "2026-09-20T08:25:11Z"
}