Skip to Content
Apex Settlement
End customers

Open an End Customer

Required permissioncustomer:end_customers:manage
POST
/v1/end-customers

Opens an End Customer of the Platform in profile_pending. The Platform then passes its onboarding for it through the Onboarding operations with Apex-End-Customer set to its id; once it is approved it is submitted to the Providers that approved the Platform. Alternatively invite_email invites its first person to do that in the Customer panel; only a person of the Platform can invite, so an API key sending invite_email is refused with people_only. country must be one the platform serves.

Requires the customer:end_customers:manage permission. Send an Idempotency-Key: a retry with the same key and body answers the first response again (marked Idempotency-Replayed: true) for 24 hours.

Authorization

ApiKey
headerAuthorizationBearer <API key>

A Customer API key, created by a Customer admin in the Customer panel and shown once: Authorization: Bearer ak_live_… in production, ak_test_… elsewhere. A key holds a subset of its creator's permissions and may be limited to named IP addresses and an expiry date. Keys never manage people, other keys or approval rules, and never approve a Payout.

Header Parameters

Idempotency-Key*string

A unique key per intended request, such as a UUID. A retry with the same key and body answers the first response again for 24 hours instead of acting twice; the same key with another body is idempotency_key_reused. An error answer is not kept, so a request that failed may be retried under its key.

Lengthlength <= 128

Request Body

The End Customer.

application/json
  1. body
country*string
email*string
Lengthlength <= 254
invite_email?string

invite_email invites the End Customer's first person; only a person of the Platform may send it.

Lengthlength <= 254
invite_name?string
Lengthlength <= 120
legal_name*string
Lengthlength <= 256
type*CustomerType
Value in"individual""business"

Response Body

Created

application/json
  1. response
country*string
created_at*string
Formatdate-time
email*string
has_people?boolean

has_people is answered on one End Customer, not on a list row.

id*string
legal_name*string
providers*array<>
standing*string
Value in"onboarding""active""suspended""closed"
state*string
Value in"profile_pending""profile_review""provider_onboarding""active""suspended""rejected"
suspended_by?string

suspended_by is who suspended it: platform (the Platform may reactivate it) or operator (only the operations team can).

Value in"operator""platform"
suspended_reason?string

suspended_reason is the Platform's own reason, shown when the Platform suspended it.

type*string
Value in"individual""business"
updated_at*string
Formatdate-time
Example Request
curl -X POST 'http://localhost:3480/v1/end-customers' \  -H 'Idempotency-Key: 5f1c2b9e-6a1d-4c3e-9b7a-2d8e4f6a1c03' \  -H 'Content-Type: application/json' \  -d '{  "country": "PK",  "email": "lina@example.com",  "legal_name": "Lina Qureshi",  "type": "individual"}'
Example Response
{  "country": "PK",  "created_at": "2026-11-10T14:05:00Z",  "email": "lina@example.com",  "has_people": false,  "id": "3f6c2a9e-8b1d-4c7a-9e2f-5a6b7c8d9e0f",  "legal_name": "Lina Qureshi",  "providers": [    {      "provider": "bvnk",      "state": "approved"    }  ],  "standing": "active",  "state": "active",  "suspended_by": "operator",  "suspended_reason": "string",  "type": "individual",  "updated_at": "2026-11-11T10:20:00Z"}