API reference
Customers
The people or businesses you hold wallets for.
Create a customer
POST/api/partner/v1/customers/create
Adds a person you will hold a wallet for. Verify their BVN first with the identity endpoints and pass the completed verification IDs, then open a wallet with POST /wallets/create.
Body
- firstnamestringrequired
Example:
"Ada" - lastnamestringrequired
Example:
"Obi" - emailstring (email)required
Example:
"ada@example.com" - phonestringrequired
A valid Nigerian phone number.
Example:
"08031234567" - dobstring (date)required
Date of birth.
Example:
"1994-05-17" - referencestringrequired
Your own ID for this customer. Must be unique among your customers; returned as
external_reference.Example:
"user_4410" - identity_verification_idsarray of string (uuid)
IDs of identity verifications you started and that succeeded.
Responses
- 201Customer created
- 401Missing, invalid or expired access token.
unauthenticated - 422A field failed validation.
validation_failed
curl -X POST https://staging.lint.finance/api/partner/v1/customers/create \
-H "Authorization: Bearer $LINT_ACCESS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"firstname": "Ada",
"lastname": "Obi",
"email": "ada@example.com",
"phone": "08031234567",
"dob": "1994-05-17",
"reference": "user_4410",
"identity_verification_ids": [
"6b1f8a52-2d0f-4e8b-9c33-0a7f5f0e9d21"
]
}'Response · 201
{
"data": {
"id": "1898107f-ab12-4b27-a483-a863b7f6982e",
"firstname": "Ada",
"lastname": "Obi",
"email": "ada@example.com",
"phone": "08031234567",
"dob": "1994-05-17",
"external_reference": "user_4410",
"verified_identities": [
{
"type": "bvn",
"value": "12345678901"
}
],
"created_at": "2026-11-02T10:58:00.000000Z",
"updated_at": "2026-11-02T10:58:00.000000Z"
},
"message": "Business customer created successfully."
}List customers
GET/api/partner/v1/customers
Your customers, paginated.
Query parameters
- pageinteger
Example:
1 - per_pageinteger
1–100. Defaults to 10.
Example:
20
Responses
- 200A page of customers
- 401Missing, invalid or expired access token.
unauthenticated - 422A field failed validation.
validation_failed
curl -X GET https://staging.lint.finance/api/partner/v1/customers \
-H "Authorization: Bearer $LINT_ACCESS_TOKEN" \
-H "Accept: application/json"Response · 200
{
"data": [
{
"id": "1898107f-ab12-4b27-a483-a863b7f6982e",
"firstname": "Ada",
"lastname": "Obi",
"email": "ada@example.com",
"phone": "08031234567",
"dob": "1994-05-17",
"external_reference": "user_4410",
"verified_identities": [
{
"type": "bvn",
"value": "12345678901"
}
],
"created_at": "2026-11-02T10:58:00.000000Z",
"updated_at": "2026-11-02T10:58:00.000000Z"
}
],
"links": {},
"meta": {}
}Retrieve a customer
GET/api/partner/v1/customers/{customer_id}
Path parameters
- customer_idstring (uuid)required
The customer's
id.Example:
"1898107f-ab12-4b27-a483-a863b7f6982e"
Responses
- 200The customer
- 401Missing, invalid or expired access token.
unauthenticated - 404The resource does not exist or belongs to another partner. The two cases are indistinguishable by design.
not_found
curl -X GET https://staging.lint.finance/api/partner/v1/customers/1898107f-ab12-4b27-a483-a863b7f6982e \
-H "Authorization: Bearer $LINT_ACCESS_TOKEN" \
-H "Accept: application/json"Response · 200
{
"data": {
"id": "1898107f-ab12-4b27-a483-a863b7f6982e",
"firstname": "Ada",
"lastname": "Obi",
"email": "ada@example.com",
"phone": "08031234567",
"dob": "1994-05-17",
"external_reference": "user_4410",
"verified_identities": [
{
"type": "bvn",
"value": "12345678901"
}
],
"created_at": "2026-11-02T10:58:00.000000Z",
"updated_at": "2026-11-02T10:58:00.000000Z"
}
}Update a customer
PATCH/api/partner/v1/customers/{customer_id}/update
Changes only the fields you send. A customer's reference and identity checks can't be changed.
Path parameters
- customer_idstring (uuid)required
The customer's
id.
Body
- firstnamestring
Example:
"Adaeze" - middlenamestring
Example:
"Chioma" - lastnamestring
Example:
"Obi" - emailstring (email)
Example:
"adaeze@example.com" - phonestring
A valid Nigerian phone number.
Example:
"08031234567" - dobstring (date)
Example:
"1994-05-17"
Responses
- 200The updated customer
- 401Missing, invalid or expired access token.
unauthenticated - 404The resource does not exist or belongs to another partner. The two cases are indistinguishable by design.
not_found - 422A field failed validation.
validation_failed
curl -X PATCH https://staging.lint.finance/api/partner/v1/customers/{customer_id}/update \
-H "Authorization: Bearer $LINT_ACCESS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"firstname": "Adaeze",
"middlename": "Chioma",
"lastname": "Obi",
"email": "adaeze@example.com",
"phone": "08031234567",
"dob": "1994-05-17"
}'Response · 200
{
"data": {
"id": "1898107f-ab12-4b27-a483-a863b7f6982e",
"firstname": "Ada",
"lastname": "Obi",
"email": "ada@example.com",
"phone": "08031234567",
"dob": "1994-05-17",
"external_reference": "user_4410",
"verified_identities": [
{
"type": "bvn",
"value": "12345678901"
}
],
"created_at": "2026-11-02T10:58:00.000000Z",
"updated_at": "2026-11-02T10:58:00.000000Z"
},
"message": "Business customer updated successfully."
}Delete a customer
DELETE/api/partner/v1/customers/{customer_id}/remove
Path parameters
- customer_idstring (uuid)required
The customer's
id.
Responses
- 204Deleted. No body.
- 401Missing, invalid or expired access token.
unauthenticated - 404The resource does not exist or belongs to another partner. The two cases are indistinguishable by design.
not_found
curl -X DELETE https://staging.lint.finance/api/partner/v1/customers/{customer_id}/remove \
-H "Authorization: Bearer $LINT_ACCESS_TOKEN" \
-H "Accept: application/json"