Skip to main content
Base URL:

Authentication

Pass your partner API key in the x-api-key header on every request.

Response conventions

  • List endpoints return { <resourcePlural>, count }.
  • Detail endpoints return { <resourceSingular> }.
  • All customer-scoped Commenda OS partner endpoints are scoped by customerId.
  • Requests without a valid x-api-key return 401 with Missing x-api-key header or Invalid API key.
  • Customer-scoped endpoints return 403 when the partner cannot access the requested customer.
  • Business-entity-scoped collection endpoints return 404 Business entity not found when the businessEntityId does not belong to the specified customer.
  • Child detail endpoints return resource-specific 404 messages such as Location not found, Government identifier not found, or Registration not found.

Available resources