Fetch one customer

GET

https://api-dev.skiplino.com/external/v1/customers/getOne

Fetches a single customer by either the internal id or your externalId.
Provide at least one. If both are sent, id takes precedence.

Authentication — Secret key only (sk_…).

Behavioural notes — The identifier is validated for existence; an unknown
id/externalId returns 422 (This value does not exist.), not 404.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Responses

🟢200

application/json

Customer fetched successfully.

Bodyapplication/json

🟠422

🟠401Unauthorized

🔴500ServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.skiplino.com/external/v1/customers/getOne?id=9f2c8b7a4e1d6c3f0a5b8e2d7c4f1a9b&externalId=crm-7741' \
--header 'X-Locale;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "message": "Customer fetched successfully.",
    "data": {
        "_id": "9f2c8b7a4e1d6c3f0a5b8e2d7c4f1a9b",
        "externalId": "crm-7741",
        "companyId": "cmp_5f3a91",
        "name": "Layla Hassan",
        "email": "layla.hassan@example.com",
        "mobile": "+97333445566",
        "metadata": {
            "tier": "gold"
        },
        "createdAt": "2026-06-23T11:00:00.000Z",
        "updatedAt": "2026-06-23T11:00:00.000Z"
    }
}

List customers (paginated)

Update a customer