Customers

Get a customer by ID

Retrieves detailed information about a specific customer.

This endpoint allows you to fetch complete customer details including their contact information and status.

Use Cases

View customer details
Verify customer information
Check customer status before processing payments

Path Parameters

id: Customer UUID (required) - Must be a valid UUID format

Example Request

GET /api/v0/customers/123e4567-e89b-12d3-a456-426614174000

Example Response

{
  "id": "cust_123456",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "phone_number": "+1-555-123-4567",
  "customer_type": "Enterprise",
  "status": "ACTIVE",
  "last_spent": 1250.50,
  "last_purchase_date": "2024-03-15T14:30:00Z",
  "created_at": "2024-03-20T10:00:00Z",
  "updated_at": "2024-03-20T10:00:00Z"
}

GET

api

customers

{id}

Get a customer by ID

curl --request GET \
  --url https://api.devdraft.ai/api/v0/customers/{id} \
  --header 'x-client-secret: <api-key>'

const options = {method: 'GET', headers: {'x-client-secret': '<api-key>'}};

fetch('https://api.devdraft.ai/api/v0/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.devdraft.ai/api/v0/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 => [
    "x-client-secret: <api-key>"
  ],
]);

$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.devdraft.ai/api/v0/customers/{id}"

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

	req.Header.Add("x-client-secret", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.devdraft.ai/api/v0/customers/{id}")

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

request = Net::HTTP::Get.new(url)
request["x-client-secret"] = '<api-key>'

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

Authorizations

x-client-secret

string

header

required

Your secret API key. Keep this secure and never expose it in client-side code.

Path Parameters

string<uuid>

required

Customer unique identifier (UUID)

Example:

"cust_123e4567-e89b-12d3-a456-426614174000"

Response

Successfully retrieved customer

⌘I

Get a customer by ID

curl --request GET \
  --url https://api.devdraft.ai/api/v0/customers/{id} \
  --header 'x-client-secret: <api-key>'

const options = {method: 'GET', headers: {'x-client-secret': '<api-key>'}};

fetch('https://api.devdraft.ai/api/v0/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.devdraft.ai/api/v0/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 => [
    "x-client-secret: <api-key>"
  ],
]);

$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.devdraft.ai/api/v0/customers/{id}"

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

	req.Header.Add("x-client-secret", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.devdraft.ai/api/v0/customers/{id}")

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

request = Net::HTTP::Get.new(url)
request["x-client-secret"] = '<api-key>'

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

API Health

Test Payments

Customers

Payment Links

Payment Intents

Webhooks

Wallets

Transfers

Liquidation Addresses

App Balances

Exchange Rates

Products

Invoices

Taxes

Get a customer by ID

Use Cases

Path Parameters

Example Request

Example Response

Authorizations

Path Parameters

Response