Settings & Offices

Manage office locations for your tenant — useful for multi-location companies.

Office Object

FeldTypPflichtBeschreibung
idintegerOptionalUnique office ID
namestringOptionalOffice namez.B. Main Office Frankfurt
citystringOptionalCity
countrystringOptionalCountry (ISO 3166-1 alpha-2)z.B. DE
addressstring|nullOptionalFull address
iata_codestring|nullOptionalIATA airport code (for aviation locations)z.B. FRA
is_defaultbooleanOptionalIs this the default office?
created_atdatetimeOptionalCreation timestamp

GET /offices — Get All Offices

GEThttps://api.aeroselect.io/api/v2/external/offices
cURLBash
curl "https://api.aeroselect.io/api/v2/external/offices" \
  -H "X-API-Key: ak_live_YOUR_KEY"
Response 200JSON
{
  "data": [
    {
      "id": 1,
      "name": "Main Office Frankfurt",
      "city": "Frankfurt am Main",
      "country": "DE",
      "address": "Airport City, Cargo City Süd, 60549 Frankfurt",
      "iata_code": "FRA",
      "is_default": true,
      "created_at": "2026-01-15T10:00:00Z"
    },
    {
      "id": 2,
      "name": "Munich Base",
      "city": "München",
      "country": "DE",
      "address": null,
      "iata_code": "MUC",
      "is_default": false,
      "created_at": "2026-02-10T09:00:00Z"
    }
  ]
}

POST /offices — Create Office

Requires scope settings:write.

POSThttps://api.aeroselect.io/api/v2/external/offices
FeldTypPflichtBeschreibung
namestringPflichtOffice name (max. 255 characters)
citystringPflichtCity
countrystringPflichtCountry (ISO 3166-1 alpha-2)
addressstringOptionalFull address
iata_codestringOptionalIATA airport code (3 letters)
cURLBash
curl -X POST "https://api.aeroselect.io/api/v2/external/offices" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Vienna Base",
    "city": "Vienna",
    "country": "AT",
    "iata_code": "VIE"
  }'

PATCH /offices/{id} — Edit Office

Requires scope settings:write.

PATCHhttps://api.aeroselect.io/api/v2/external/offices/{id}
cURLBash
curl -X PATCH "https://api.aeroselect.io/api/v2/external/offices/3" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Vienna Hub", "address": "Vienna International Airport, 1300 Vienna-Airport" }'

DELETE /offices/{id} — Delete Office

Requires scope settings:write.

DELETEhttps://api.aeroselect.io/api/v2/external/offices/{id}

Default office is protected

The default office (is_default: true) cannot be deleted. Assign the default property to another office before deleting the current default office.
cURLBash
curl -X DELETE "https://api.aeroselect.io/api/v2/external/offices/3" \
  -H "X-API-Key: ak_live_YOUR_KEY"
Response 200JSON
{ "message": "Office deleted." }