Organization | Locations

Retrieve a list of locations of your organization tenant.

get

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Query parameters

searchstringOptional

Filter the result by searching for name

sortBystring · enumOptional

Parameters according to which a location can be sorted.

Possible values:

sortOrderstring · enumOptional

Order in which the result of a list request is sorted.

Possible values:

offsetinteger · int32Optional

Specifies the index of the first item to return

Default: 0

limitinteger · int32Optional

Specifies the maximum number of items to return (min: 1; max: 1000)

Default: 100

Responses

200

OK: The requested location.

application/json

totalinteger · int32Required

400

Bad request: See response message for details.

application/json

401

Unauthorized: Invalid api key.

application/json

403

Forbidden: Resource access denied or resource does not exist anymore.

application/json

get/v1/organization/locations

GET /v1/organization/locations HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "created": "2026-07-15T14:23:03.959Z",
      "address": {
        "line1": "equipme GmbH",
        "street": "W 55th St",
        "number": 240,
        "addition": "3rd floor",
        "city": "New York",
        "postalCode": 10019,
        "countryCode": "US",
        "regionCode": "NY",
        "regionName": "New York",
        "dependentLocality": "Chilmington Green",
        "phoneNumber": "+1 212-555-1234",
        "id": 83,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "managers": [
        {
          "managerPolicy": "text",
          "id": 1,
          "firstName": "Pierce",
          "lastName": "Bell",
          "fullName": "text",
          "email": "p.bell@foo.io",
          "username": "j.doe@foo.inc",
          "costCenter": "4645-2343",
          "costCenterId": 1,
          "self": {
            "href": "text",
            "method": "text"
          }
        }
      ],
      "metadataItems": [
        {
          "value": "EQ1337555",
          "scope": "Supplier",
          "key": "ExternalSystemId",
          "self": {
            "href": "text",
            "method": "text"
          }
        }
      ],
      "costCenter": {
        "description": "text",
        "id": 1,
        "code": "text",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "id": 1,
      "name": "HQ New York",
      "type": "location",
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}

Creates a location.

post

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Body

namestring · max: 100Required

The name of the location.

Example: foo Inc.

costCenterIdinteger · int32 · nullableOptional

Location cost center

Responses

201

Created: The created location.

application/json

createdstring · date-timeOptional

The date and time the data record was created.

idinteger · int32Required

The identifier of the company location.

Example: 1

namestring · max: 100Required

The name of the company location.

Example: HQ New York

typestring · enumRequired

The type of location.

Possible values:

400

Bad request: See response message for details.

application/json

401

Unauthorized: Invalid api key.

application/json

403

Forbidden: Resource access denied or resource does not exist anymore.

application/json

post/v1/organization/locations

POST /v1/organization/locations HTTP/1.1
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 356

{
  "name": "foo Inc.",
  "address": {
    "line1": "equipme GmbH",
    "street": "W 55th St",
    "number": 240,
    "addition": "3rd floor",
    "city": "New York",
    "postalCode": 10019,
    "countryCode": "US",
    "regionCode": "NY",
    "regionName": "New York",
    "dependentLocality": "Chilmington Green",
    "phoneNumber": "+1 212-555-1234"
  },
  "managers": [
    {
      "employeeId": 1,
      "role": "location-executive"
    }
  ],
  "costCenterId": 1
}

{
  "created": "2026-07-15T14:23:03.959Z",
  "address": {
    "line1": "equipme GmbH",
    "street": "W 55th St",
    "number": 240,
    "addition": "3rd floor",
    "city": "New York",
    "postalCode": 10019,
    "countryCode": "US",
    "regionCode": "NY",
    "regionName": "New York",
    "dependentLocality": "Chilmington Green",
    "phoneNumber": "+1 212-555-1234",
    "id": 83,
    "self": {
      "href": "text",
      "method": "text"
    }
  },
  "managers": [
    {
      "managerPolicy": "text",
      "id": 1,
      "firstName": "Pierce",
      "lastName": "Bell",
      "fullName": "text",
      "email": "p.bell@foo.io",
      "username": "j.doe@foo.inc",
      "costCenter": "4645-2343",
      "costCenterId": 1,
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "metadataItems": [
    {
      "value": "EQ1337555",
      "scope": "Supplier",
      "key": "ExternalSystemId",
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "costCenter": {
    "description": "text",
    "id": 1,
    "code": "text",
    "self": {
      "href": "text",
      "method": "text"
    }
  },
  "id": 1,
  "name": "HQ New York",
  "type": "location",
  "self": {
    "href": "text",
    "method": "text"
  }
}

Retrieve a single location by its id.

get

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters

locationIdinteger · int32Required

The identifier of the location.

Responses

200

OK: The requested location.

application/json

createdstring · date-timeOptional

The date and time the data record was created.

idinteger · int32Required

The identifier of the company location.

Example: 1

namestring · max: 100Required

The name of the company location.

Example: HQ New York

typestring · enumRequired

The type of location.

Possible values:

400

Bad request: See response message for details.

application/json

401

Unauthorized: Invalid api key.

application/json

403

Forbidden: Resource access denied or resource does not exist anymore.

application/json

404

NotFound: Requested resource could not be found.

application/json

get/v1/organization/locations/{locationId}

GET /v1/organization/locations/{locationId} HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "created": "2026-07-15T14:23:03.959Z",
  "address": {
    "line1": "equipme GmbH",
    "street": "W 55th St",
    "number": 240,
    "addition": "3rd floor",
    "city": "New York",
    "postalCode": 10019,
    "countryCode": "US",
    "regionCode": "NY",
    "regionName": "New York",
    "dependentLocality": "Chilmington Green",
    "phoneNumber": "+1 212-555-1234",
    "id": 83,
    "self": {
      "href": "text",
      "method": "text"
    }
  },
  "managers": [
    {
      "managerPolicy": "text",
      "id": 1,
      "firstName": "Pierce",
      "lastName": "Bell",
      "fullName": "text",
      "email": "p.bell@foo.io",
      "username": "j.doe@foo.inc",
      "costCenter": "4645-2343",
      "costCenterId": 1,
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "metadataItems": [
    {
      "value": "EQ1337555",
      "scope": "Supplier",
      "key": "ExternalSystemId",
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "costCenter": {
    "description": "text",
    "id": 1,
    "code": "text",
    "self": {
      "href": "text",
      "method": "text"
    }
  },
  "id": 1,
  "name": "HQ New York",
  "type": "location",
  "self": {
    "href": "text",
    "method": "text"
  }
}

Deprecated

Updates a location. (deprecated - please use the PATCH route instead)

put

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters

locationIdinteger · int32Required

The identifier of the location to be updated.

Body

namestring · max: 100Required

The name of the location.

Example: foo Inc.

addressIdinteger · int32 · nullableOptional

costCenterIdinteger · int32 · nullableOptional

Location Cost Center

Responses

204

NoContent: Request has succeeded.

No content

400

Bad request: See response message for details.

application/json

401

Unauthorized: Invalid api key.

application/json

403

Forbidden: Resource access denied or resource does not exist anymore.

application/json

404

NotFound: Requested resource could not be found.

application/json

put/v1/organization/locations/{locationId}

PUT /v1/organization/locations/{locationId} HTTP/1.1
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 368

{
  "name": "foo Inc.",
  "address": {
    "line1": "equipme GmbH",
    "street": "W 55th St",
    "number": 240,
    "addition": "3rd floor",
    "city": "New York",
    "postalCode": 10019,
    "countryCode": "US",
    "regionCode": "NY",
    "regionName": "New York",
    "dependentLocality": "Chilmington Green",
    "phoneNumber": "+1 212-555-1234"
  },
  "managers": [
    {
      "employeeId": 1,
      "role": "location-manager"
    }
  ],
  "addressId": 1,
  "costCenterId": 1
}

No content

patch

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters

locationIdinteger · int32Required

Query parameters

updateInstancesCostCenterbooleanOptionalDefault: true

Bodyobject · Operation[]

valueany · nullableOptional

pathstring · nullableOptional

opstring · nullableOptional

fromstring · nullableOptional

Responses

204

No Content

No content

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

patch/v1/organization/locations/{locationId}

PATCH /v1/organization/locations/{locationId} HTTP/1.1
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 887

[
  {
    "op": "add",
    "path": "/name",
    "value": "foo Inc."
  },
  {
    "op": "add",
    "path": "/address/line1",
    "value": "equipme GmbH"
  },
  {
    "op": "add",
    "path": "/address/street",
    "value": "W 55th St"
  },
  {
    "op": "add",
    "path": "/address/number",
    "value": "240"
  },
  {
    "op": "add",
    "path": "/address/addition",
    "value": "3rd floor"
  },
  {
    "op": "add",
    "path": "/address/city",
    "value": "New York"
  },
  {
    "op": "add",
    "path": "/address/postalCode",
    "value": "10019"
  },
  {
    "op": "add",
    "path": "/address/countryCode",
    "value": "US"
  },
  {
    "op": "add",
    "path": "/address/regionCode",
    "value": "NY"
  },
  {
    "op": "add",
    "path": "/address/regionName",
    "value": "New York"
  },
  {
    "op": "add",
    "path": "/address/dependentLocality",
    "value": "Chilmington Green"
  },
  {
    "op": "add",
    "path": "/address/phoneNumber",
    "value": "+1 212-555-1234"
  },
  {
    "op": "add",
    "path": "/managers/-",
    "value": {
      "employeeId": 1,
      "role": "location-manager"
    }
  },
  {
    "op": "add",
    "path": "/managers/0",
    "value": {}
  },
  {
    "op": "add",
    "path": "/costCenterId",
    "value": 123
  }
]

No content

Get all metadata entries for a specific location

get

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters

locationIdinteger · int32Required

Responses

200

application/json

totalinteger · int32Required

400

Bad request: See response message for details.

application/json

401

Unauthorized: Invalid api key.

application/json

403

Forbidden: Resource access denied or resource does not exist anymore.

application/json

404

NotFound: Requested resource could not be found.

get/v1/organization/locations/{locationId}/metadata

GET /v1/organization/locations/{locationId}/metadata HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "value": "EQ1337555",
      "scope": "Supplier",
      "key": "ExternalSystemId",
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}

Create a metadata entry for a location

post

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters

locationIdinteger · int32Required

Body

DTO for creating a new metadata entry for a given resource which implements the logic

keystring · max: 150 · nullableOptional

Key for the new metadata entry

valuestring · max: 500 · nullableOptional

Metadata value

Responses

201

Created: The created metadata entry.

application/json

valuestring · max: 500 · nullableOptional

Metadata value

Example: EQ1337555

scopestring · nullableOptional

Metadata scope. Can be Customer or Supplier to indicate the metadata is specific to a customer or supplier.

Example: Supplier

keystring · max: 150Required

Metadata key used as a unique identifier for the metadata item.

Example: ExternalSystemId

400

Bad request: See response message for details.

application/json

401

Unauthorized: Invalid api key.

application/json

403

Forbidden: Resource access denied or resource does not exist anymore.

application/json

404

NotFound: Requested resource could not be found.

application/json

post/v1/organization/locations/{locationId}/metadata

POST /v1/organization/locations/{locationId}/metadata HTTP/1.1
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "key": "text",
  "value": "text"
}

{
  "value": "EQ1337555",
  "scope": "Supplier",
  "key": "ExternalSystemId",
  "self": {
    "href": "text",
    "method": "text"
  }
}

Get a single metadata item for a location

get

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters

locationIdinteger · int32Required

keystringRequired

Responses

200

application/json

valuestring · max: 500 · nullableOptional

Metadata value

Example: EQ1337555

scopestring · nullableOptional

Metadata scope. Can be Customer or Supplier to indicate the metadata is specific to a customer or supplier.

Example: Supplier

keystring · max: 150Required

Metadata key used as a unique identifier for the metadata item.

Example: ExternalSystemId

400

Bad request: See response message for details.

application/json

401

Unauthorized: Invalid api key.

application/json

403

Forbidden: Resource access denied or resource does not exist anymore.

application/json

404

NotFound: Requested resource could not be found.

get/v1/organization/locations/{locationId}/metadata/{key}

GET /v1/organization/locations/{locationId}/metadata/{key} HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "value": "EQ1337555",
  "scope": "Supplier",
  "key": "ExternalSystemId",
  "self": {
    "href": "text",
    "method": "text"
  }
}

Get a metadata entry for a location

delete

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Path parameters

locationIdinteger · int32Required

keystringRequired

Responses

204

NoContent

No content

400

Bad request: See response message for details.

application/json

401

Unauthorized: Invalid api key.

application/json

403

Forbidden: Resource access denied or resource does not exist anymore.

application/json

404

NotFound: Requested resource could not be found.

delete/v1/organization/locations/{locationId}/metadata/{key}

DELETE /v1/organization/locations/{locationId}/metadata/{key} HTTP/1.1
X-API-KEY: YOUR_API_KEY
Accept: */*

No content

Search for specific locations based on metadata key and value. Multiple keys can be provided.

post

Authorizations

X-API-KEYstringRequired

Required for authorization in every request. You can request an API-Key for your tenant in the integrations section of the equipme App.

Body

metadataScopestring · enumOptionalPossible values:

Responses

200

application/json

totalinteger · int32Required

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

post/v1/organization/locations/search

POST /v1/organization/locations/search HTTP/1.1
X-API-KEY: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 152

{
  "metadataScope": "Supplier",
  "metaDataFilter": [
    {
      "value": "EQ1337555",
      "scope": "Supplier",
      "key": "ExternalSystemId",
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ]
}

{
  "previous": {
    "href": "text",
    "method": "text"
  },
  "next": {
    "href": "text",
    "method": "text"
  },
  "items": [
    {
      "created": "2026-07-15T14:23:03.959Z",
      "address": {
        "line1": "equipme GmbH",
        "street": "W 55th St",
        "number": 240,
        "addition": "3rd floor",
        "city": "New York",
        "postalCode": 10019,
        "countryCode": "US",
        "regionCode": "NY",
        "regionName": "New York",
        "dependentLocality": "Chilmington Green",
        "phoneNumber": "+1 212-555-1234",
        "id": 83,
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "managers": [
        {
          "managerPolicy": "text",
          "id": 1,
          "firstName": "Pierce",
          "lastName": "Bell",
          "fullName": "text",
          "email": "p.bell@foo.io",
          "username": "j.doe@foo.inc",
          "costCenter": "4645-2343",
          "costCenterId": 1,
          "self": {
            "href": "text",
            "method": "text"
          }
        }
      ],
      "metadataItems": [
        {
          "value": "EQ1337555",
          "scope": "Supplier",
          "key": "ExternalSystemId",
          "self": {
            "href": "text",
            "method": "text"
          }
        }
      ],
      "costCenter": {
        "description": "text",
        "id": 1,
        "code": "text",
        "self": {
          "href": "text",
          "method": "text"
        }
      },
      "id": 1,
      "name": "HQ New York",
      "type": "location",
      "self": {
        "href": "text",
        "method": "text"
      }
    }
  ],
  "total": 1,
  "self": {
    "href": "text",
    "method": "text"
  }
}

Last updated 1 hour ago

Was this helpful?