Remove a customer
Remove a customer
Overview
Remove a customer
Stops returning the customer in list and detail views for your organization.
When to use this
Use for GDPR-style deletion requests or when you must disable a buyer record from merchant-facing APIs.
Good to know
Behavior follows platform rules for retained financial records; confirm with your compliance team for legal holds.
Authentication
Merchant routes require an API key in the X-API-KEY header (see Integration overview). Use a test key against https://sandbox.api.lomi.africa and a live key against https://api.lomi.africa.
Endpoint
DELETE /customers/{id}
Base URLs:
https://sandbox.api.lomi.africahttps://api.lomi.africa
Request
Path parameters
| Name | Required | Schema | Description |
|---|---|---|---|
id | Yes | - | UUID du client |
Query parameters
No query parameters.
Responses
| Status | Description |
|---|---|
200 | Success |
401 | Invalid or missing API key |
404 | Resource not found |
Errors
Errors follow the standard JSON error format (status code and machine-readable message). Validate inputs before calling; 401 indicates a missing/invalid key, 404 a missing resource for this organization, 429 rate limiting. For safe retries on create-style calls, send an idempotency key when your flow supports it.
Example
curl -sS -X DELETE "https://sandbox.api.lomi.africa/customers/value" \
-H "X-API-KEY: $LOMI_SECRET_KEY"OpenAPI
- operationId:
CustomersController_remove - Operation:
DELETE /customers/{id}
Full schemas and Try it: API reference. Machine-readable contract: repo apps/docs/openapi.json.