Skip to main content
GET
/
v1
/
customers
/
{key}
Get customer
curl --request GET \
  --url https://api.example.com/v1/customers/{key}
{
  "data": {
    "key": "customer_123",
    "partner": "partner_123",
    "deleted": false,
    "name": "Alice",
    "surname": "Brown",
    "email": "[email protected]",
    "status": "active",
    "created_at": "2025-05-02T16:12:39.000000Z",
    "updated_at": "2025-05-02T16:12:39.000000Z",
    "deleted_at": null,
    "tags": [
      {
        "value": "premium"
      }
    ]
  },
  "status": 1
}

​
Endpoint

GET https://api.partnero.com/v1/customers/{key}

​
Path parameters

ParameterTypeRequiredDescription
keystringYesCustomer’s unique key

​
Request

cURL
curl --location 'https://api.partnero.com/v1/customers/customer_123' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'

​
Response

{
  "data": {
    "key": "customer_123",
    "partner": "partner_123",
    "deleted": false,
    "name": "Alice",
    "surname": "Brown",
    "email": "[email protected]",
    "status": "active",
    "created_at": "2025-05-02T16:12:39.000000Z",
    "updated_at": "2025-05-02T16:12:39.000000Z",
    "deleted_at": null,
    "tags": [
      {
        "value": "premium"
      }
    ]
  },
  "status": 1
}

​
Response fields

FieldTypeDescription
keystringUnique customer identifier
emailstringCustomer’s email address
namestringCustomer’s first name
surnamestringCustomer’s last name
partnerstringKey of the referring partner
statusstringCustomer status
deletedbooleanWhether customer is soft-deleted
tagsarrayCustomer tags (each with a value key)
created_atstringISO 8601 timestamp
updated_atstringISO 8601 timestamp
deleted_atstring|nullDeletion timestamp if deleted

​
Get customer transactions

Retrieve all transactions for a specific customer: 
GET https://api.partnero.com/v1/customers/{key}/transactions
cURL
curl --location 'https://api.partnero.com/v1/customers/customer_123/transactions' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY'