Get Customer by ID

Customer details

curl --request GET \
  --url https://api.cartevo.co/api/v1/customers/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.cartevo.co/api/v1/customers/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cartevo.co/api/v1/customers/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cartevo.co/api/v1/customers/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cartevo.co/api/v1/customers/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.cartevo.co/api/v1/customers/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cartevo.co/api/v1/customers/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "id": "4d4dad81-7899-4612-a9f6-133ce56a4507",
    "email": "customer@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "is_active": true,
    "country": "Cameroon",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

GET

customers

{id}

Customer details

curl --request GET \
  --url https://api.cartevo.co/api/v1/customers/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.cartevo.co/api/v1/customers/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cartevo.co/api/v1/customers/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cartevo.co/api/v1/customers/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cartevo.co/api/v1/customers/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.cartevo.co/api/v1/customers/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.cartevo.co/api/v1/customers/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "id": "4d4dad81-7899-4612-a9f6-133ce56a4507",
    "email": "customer@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "is_active": true,
    "country": "Cameroon",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Overview

GET /customers/{id} returns full details of a single customer in your company.

When to use it

Display a customer profile in your dashboard.
Check a customer’s status before issuing them a card.
Reconcile a single customer record.

Prerequisites

The customer must belong to your company.

Request

Headers

Name	Required	Description
`Authorization`	Yes	`Bearer <access_token>`

Path parameters

Name	Type	Description
`id`	string	Customer ID (UUID).

Response

200 — Success

{
  "success": true,
  "statusCode": 200,
  "message": "Data retrieved successfully",
  "data": {
    "id": "8d4f2a1b-5c3e-4d7f-9a6b-2e1c8f9d0a3b",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "country": "Cameroon",
    "street": "123 Main Street",
    "city": "Yaoundé",
    "state": "Centre",
    "postal_code": "00237",
    "phone_country_code": "+237",
    "phone_number": "600000000",
    "identification_number": "12345678901",
    "type": "NIN",
    "number": "12345678901",
    "image": "https://cdn.cartevo.co/kyc/.../front.jpg",
    "photo": "https://cdn.cartevo.co/kyc/.../back.jpg",
    "date_of_birth": "1990-01-15T00:00:00.000Z",
    "is_active": true,
    "created_at": "2026-05-09T10:15:00.000Z",
    "updated_at": "2026-05-09T10:15:00.000Z"
  }
}

Field reference

Field	Type	Description
`id`	string	Customer ID (UUID).
`first_name`, `last_name`	string	As submitted at creation.
`email`	string	Customer’s email address. Unique within your company.
`country`	string	Full country name as submitted.
`street`, `city`, `state`, `postal_code`	string	Postal address.
`phone_country_code`	string	Dial code with `+` (e.g. `+237`).
`phone_number`	string	Local subscriber number.
`type`	string	The `id_document_type` submitted (`NIN`, `PASSPORT`, `VOTERS_CARD`, `DRIVERS_LICENSE`).
`number`	string	The `identification_number` submitted.
`image`	string	URL to the front of the ID document. Cartevo-hosted if you uploaded files; your own URL if you used `/customers/enroll`.
`photo`	string	URL to the back of the ID document, when applicable.
`date_of_birth`	string	ISO 8601.
`is_active`	boolean	`true` for active customers; `false` if disabled by Cartevo.
`created_at` / `updated_at`	string	ISO 8601 timestamps.

Error responses

Status	Trigger
`404`	Customer does not exist or belongs to another company.

Code examples

cURL

curl https://api.cartevo.co/api/v1/customers/8d4f2a1b-5c3e-4d7f-9a6b-2e1c8f9d0a3b \
  -H "Authorization: Bearer $TOKEN"

Node.js (axios)

const { data } = await axios.get(
  `https://api.cartevo.co/api/v1/customers/${customerId}`,
  { headers: { Authorization: `Bearer ${token}` } }
);

GET /customers — list all customers.
GET /customers/{id}/transactions — this customer’s transaction history.
POST /cards — issue a card to this customer.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string<uuid>

required

Response

Detailed information for a single customer.

success

boolean

Example:

true

statusCode

integer

Example:

200

message

string

Example:

"Data retrieved successfully"

data

object

Show child attributes

Enroll Customer List Customer Cards

API documentation

Auth

Cards

Customers

Wallets

Payment Collection

Webhook

Overview

When to use it

Prerequisites

Request

Headers

Path parameters

Response

200 — Success

Field reference

Error responses

Code examples

Authorizations

Path Parameters

Response

​Overview

​When to use it

​Prerequisites

​Request

​Headers

​Path parameters

​Response

​200 — Success

​Field reference

​Error responses

​Code examples

​Related

Authorizations

Path Parameters

Response

Overview

When to use it

Prerequisites

Request

Headers

Path parameters

Response

200 — Success

Field reference

Error responses

Code examples

Related