Skip to main content

Endpoint

GET /api/customers/:id Retrieves detailed information about a specific customer using their Stripe customer ID.

Request

id
string
required
The Stripe customer ID (format: cus_...)

Response

status
boolean
Indicates if the request was successful
message
string
Response message describing the result
data
object
Complete Stripe customer object with all customer details including:

Examples

curl -X GET https://your-domain.com/api/customers/cus_1234567890abcdef \
  -H "Content-Type: application/json"

Response Examples

Success (200)

{
  "status": true,
  "message": "Cliente obtenido correctamente",
  "data": {
    "id": "cus_1234567890abcdef",
    "object": "customer",
    "email": "[email protected]",
    "name": "John Doe",
    "phone": "+1234567890",
    "created": 1234567890,
    "default_source": null,
    "balance": 0,
    "currency": "usd"
  }
}

Error (400)

{
  "status": false,
  "message": "id es requerido",
  "code": null
}

Error (404)

{
  "status": false,
  "message": "Cliente no encontrado",
  "code": "resource_missing"
}

Error (500)

{
  "status": false,
  "message": "Error interno del servidor",
  "code": null
}

Build docs developers (and LLMs) love