> ## 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.

# Partner API

> Use Commenda's Partner API to create customers, manage entity data, start incorporations, upload files, track issues, and receive webhooks.

The Partner API gives you a customer-scoped API surface for building incorporation and entity management flows inside your product.

Base URL:

```text theme={null}
https://api.prod.commenda.io/api/v1
```

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

```bash theme={null}
curl --request GET \
  --url 'https://api.prod.commenda.io/api/v1/partner/incorporation/jurisdiction-catalog' \
  --header 'x-api-key: <partner_api_key>'
```

## What you can build

<Columns cols={2}>
  <Card title="Create a customer" icon="building" href="/engine/partner-api/customers-POST">
    Create the customer record that owns incorporations and reusable entity data.
  </Card>

  <Card title="Start an incorporation" icon="handshake" href="/engine/incorporation/partner-incorporation-introduction">
    Collect requirements, submit intake, track status, and resolve correction requests.
  </Card>

  <Card title="Manage people and entities" icon="database" href="/engine/commendaos/partner-api/commenda-os-introduction">
    Create and reuse customer records such as business entities, people, files, documents, government identifiers, and registrations.
  </Card>

  <Card title="Receive updates" icon="webhook" href="/engine/partner-webhooks/partner-webhooks">
    Subscribe to events and verify signed webhook deliveries.
  </Card>
</Columns>

## Response conventions

For the full naming, ID, casing, wrapper, validation, file, and error conventions, read [Partner API conventions](/engine/partner-api/conventions).

* Customer-scoped endpoints only return resources visible to the partner firm associated with the API key.
* List endpoints return an object containing the resource list and `count`.
* Detail endpoints return an object containing the requested resource.
* Requests without a valid `x-api-key` return `401`.
* Requests for a customer or resource outside the partner firm's scope return `403` or `404`, depending on the endpoint boundary.

## Next steps

<Columns cols={2}>
  <Card title="Understand incorporation concepts" icon="map" href="/engine/incorporation/partner-incorporation-core-concepts">
    Review the object model, IDs to save, and Commenda OS dependency before implementation.
  </Card>

  <Card title="Build an incorporation flow" icon="list-checks" href="/engine/incorporation/partner-incorporation-build-flow">
    Follow the recommended end-to-end sequence for partner-led incorporations.
  </Card>
</Columns>