Customers overview

Use the Customers API to create customer records, list customers, retrieve an individual customer, and update customer information.

Create a customer or browse the operations in this category.

Follow the end-to-end customer onboarding guide.

How it works

The customer is the root record that everything else in Gravv attaches to — KYC verification, accounts, wallets, cards, and transfers all reference a customer_id. A typical onboarding sequence is:

Create the customer with their personal or business details.
Verify the customer through KYC.
Open accounts, wallets, or cards for the verified customer.

Endpoints

Endpoint	Description
`POST /v1/customers`	Create a customer record
`GET /v1/customers`	List customers with filters and pagination
`GET /v1/customers/{customer_id}`	Retrieve a single customer
`PUT /v1/customers/{customer_id}`	Update a customer — only provided fields are updated

When updating a customer, the service reads customer_id from the request body (where it is required); the path parameter is cosmetic. Updates are partial — fields you omit keep their current values.

Authentication

All requests use https://api.gravv.xyz/v1/ and authenticate with the Api-Key header. See Authentication for details.

Was this page helpful?