Authentication
Pass your partner API key in thex-api-key header on every request.
Response conventions
- List endpoints return
{ <resourcePlural>, count }. - Detail endpoints return
{ <resourceSingular> }. - All company-scoped Commenda OS partner endpoints are scoped by
companyId. - Requests without a valid
x-api-keyreturn401withMissing x-api-key headerorInvalid API key. - Company-scoped endpoints return
403withCompany does not belong to this partner firmwhen the partner cannot access the requested company. - Business-entity-scoped collection endpoints return
404 Business entity not foundwhen thebusinessEntityIddoes not belong to the specified company. - Child detail endpoints return resource-specific
404messages such asLocation not found,Government identifier not found, orRegistration not found.