Retrieve and update company metadata. Supports both Partner Key and Company Key. Endpoints:
  • GET /v1/companies (Partner Key) — list all companies under the partner
  • GET /v1/companies/{id} (Partner Key or Company Key) — get company details
  • PATCH /v1/companies/{id} (Company Key) — update company metadata
List companies:
  Partner ──GET /v1/companies──> API
         <── 200 OK [ { companyId, name, status, ... } ]

Get specific company:
  Partner ──GET /v1/companies/{id}──> API
         <── 200 OK { companyId, name, legalName, country, ... }

Update company:
  Partner ──PATCH /v1/companies/{id}──> API
         <── 200 OK { updated company }
PATCH Request (partial update):
{
  "name": "Acme Corporation (Updated)",
  "country": "UK",
  "city": "London"
}
Key behaviors:
  • GET /v1/companies is partner-scoped — only returns companies linked to the authenticated partner
  • PATCH only updates provided fields (null fields are ignored)
  • Company Key can only access its own company data