# SVRN Client API

> Reference documentation for the sequential client flow: authentication, onboarding, due diligence, and reconciliation.

## Docs

- [](https://docs.svrn.digital/index.md)
- [API Overview](https://docs.svrn.digital/api-overview.md): How the sequential client API is organized and how each workflow step fits together.
- [Platform Workflow](https://docs.svrn.digital/architecture-overview.md): How the published client workflows move from request submission to final status.
- [Overview](https://docs.svrn.digital/authentication-guide.md): How clients exchange issued headers for a bearer token.
- [Exchange client credentials for a bearer token](https://docs.svrn.digital/api-reference/01-authentication/exchange-client-credentials-for-a-bearer-token.md): The live implementation expects client credentials in headers, not in a JSON body.
- [Overview](https://docs.svrn.digital/onboarding-guide.md): Create customers, track KYC state, resume verification, and register artist PIX details.
- [Create a customer and start SVRN onboarding](https://docs.svrn.digital/api-reference/02-onboarding/create-a-customer-and-start-svrn-onboarding.md)
- [List customers for the authenticated client](https://docs.svrn.digital/api-reference/02-onboarding/list-customers-for-the-authenticated-client.md)
- [Get a customer](https://docs.svrn.digital/api-reference/02-onboarding/get-a-customer.md)
- [Delete a customer](https://docs.svrn.digital/api-reference/02-onboarding/delete-a-customer.md)
- [Resume verification for a customer](https://docs.svrn.digital/api-reference/02-onboarding/resume-verification-for-a-customer.md)
- [Register or replace an artist PIX bank account](https://docs.svrn.digital/api-reference/02-onboarding/register-or-replace-an-artist-pix-bank-account.md): This is the route used by the current client scripts and Lambda handler. LABEL customers are rejected.
- [Overview](https://docs.svrn.digital/due-diligence-guide.md): Open due diligence cases, request upload URLs, publish offers, and poll the case state.
- [Initialize a due diligence case](https://docs.svrn.digital/api-reference/03-due-diligence/initialize-a-due-diligence-case.md): This endpoint opens the case and returns a due_diligence_id. Presigned upload URLs are requested in a second step via POST /due-diligence/{due_diligence_id}/uploads.
- [Get a due diligence case](https://docs.svrn.digital/api-reference/03-due-diligence/get-a-due-diligence-case.md)
- [Request presigned upload URLs for due diligence files](https://docs.svrn.digital/api-reference/03-due-diligence/request-presigned-upload-urls-for-due-diligence-files.md)
- [Publish a credit offer for a due diligence case](https://docs.svrn.digital/api-reference/03-due-diligence/publish-a-credit-offer-for-a-due-diligence-case.md): Publishes the offer, sends confirmation emails to the signing parties, and returns the updated due diligence state. Client integrations should then poll GET /due-diligence/{due_diligence_id} until the status reaches SIGNED or another terminal state.
- [Overview](https://docs.svrn.digital/reconciliation-guide.md): Open reconciliations for a contract, upload statements, and track settlement progress.
- [Initialize a reconciliation for a contract](https://docs.svrn.digital/api-reference/04-reconciliation/initialize-a-reconciliation-for-a-contract.md): Creates a reconciliation and returns the identifiers and funding context for settlement processing.
- [Get a reconciliation](https://docs.svrn.digital/api-reference/04-reconciliation/get-a-reconciliation.md)
- [Request presigned upload URLs for reconciliation files](https://docs.svrn.digital/api-reference/04-reconciliation/request-presigned-upload-urls-for-reconciliation-files.md)

## OpenAPI Specs

- [svrn-integration-api](https://docs.svrn.digital/contracts/svrn-integration-api.json)
- [openapi](https://docs.svrn.digital/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.