Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.commenda.io/llms.txt

Use this file to discover all available pages before exploring further.

Overview

The Locations API lets you manage physical locations for a corporation. Locations are used to determine tax nexus, registration obligations, and establishment presence — particularly for EU trade bloc registrations where physical presence in a member state affects which registration schemes are available.

Location types

TypeDescription
HEADQUARTERSMain administrative office
BRANCH_OFFICESecondary office location
RETAIL_LOCATIONCustomer-facing retail store
FACTORYManufacturing facility
WAREHOUSEInventory storage or distribution center
NATURAL_RESOURCE_SITENatural resource extraction site
REGISTERED_OFFICEOfficial legal address on file with authorities
REPRESENTATIVE_OFFICERepresentative office in a foreign jurisdiction
CONSTRUCTION_SITEActive construction project site
THIRD_PARTY_FULFILLMENTThird-party fulfillment center
REMOTE_EMPLOYEELocation where remote employees work
DEPENDENT_AGENTAgent who acts exclusively on behalf of the company
INDEPENDENT_AGENTAgent who acts on behalf of multiple companies
REGISTRATIONLocation linked to a tax registration
OTHEROther location type
A single location can have multiple types (e.g., ["HEADQUARTERS", "REGISTERED_OFFICE"]).

Establishment rules

Locations are checked when creating EU trade bloc registrations:
  • Union OSS requires a qualifying EU establishment (headquarters, branch office, warehouse, factory, retail location, or dependent agent) in the member state country.
  • Non-Union OSS requires that you have no qualifying EU establishment in any EU country.

API endpoints

EndpointMethodDescription
/locationsPOSTCreate a location
/locationsGETList locations for a corporation
/locations/{location_id}POSTUpdate a location
/locations/{location_id}DELETEDelete (archive) a location