Retrieve Customer

Overview

This endpoint allows you to retrieve the details of a specific entity customer within the Passport API using the entity's unique ID. The response includes identification, business details, and contact information.

Endpoint Details

Definition	Description
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/customers/:customer_id
Method	GET
Headers	Authorization
Authentication	Access Token (Bearer Token)

Replace customer_id with the actual unique ID of the Customer that was linked in the initial request.

Request Body

No request body

Example Request

JSON
    
curl --location --request GET 'https://api.paas.sandbox.co.passportfintech.com/v1/customers/db7e89e7-59d8-4ab1-b675-a2ae52c3339e' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
Copy

Response Body

HTTP Status Code: 200 OK.
The response contains the clients data.

Example of Response

JSON
    
 
{
    "business_name": "changing",
    "type": "BUSINESS",
    "created_at": "2025-10-09T10:40:27.446Z",
    "updated_at": "2025-10-09T17:19:27.951Z",
    "email": "eAqpUh6u@example.com",
    "status": "ACTIVE",
    "identification_number": "903978023",
    "merchant_category_code": "0412",
    "mobile_phone_number": "573956158117",
    "address": {
        "line_3": "Calle 20 675",
        "city": "Cartagena",
        "line_1": "Diagonal 46 1104",
        "country": "CO",
        "post_code": "101010",
        "state": "Bolivar",
        "line_2": "Carrera 18 2111"
    },
    "identification_type": "NIT",
    "id": "db7e89e7-59d8-4ab1-b675-a2ae52c3339e"
}
Copy

Common Errors and Handling

HTTP Status Code	Meaning	Description
400 Bad Request	Invalid Request	The entity ID is missing or incorrectly formatted.
401 Unauthorized	Expired Token	The access token is invalid or has expired.
403 Forbidden	Access Denied	The request is not authorized to retrieve this entity.
404 Not Found	Entity Not Found	No entity was found with the given ID.
500 Internal Server Error	Server Error	An unexpected error occurred while retrieving the entity.

Best Practices

Ensure the customer_id is correctly provided in the request URL.
Use the retrieved entity ID for subsequent API interactions.

Last updated on