Get Customer

Returns the full record of a single customer, identified by its Sodtrack id.

GET/api/integration/customer/{customerId}

Request

cURL

curl -X GET "https://uat.integration.cl.sodtrack-shared.sodtrack.com/api/integration/customer/{customerId}" \
  -H "Authorization: Bearer $SODTRACK_TOKEN"

Base URL: https://uat.integration.cl.sodtrack-shared.sodtrack.com · other environments

Path parameters

Name	Type	Description
`customerId`required	string	—

Responses

Get Customer

{
  "id": 2001,
  "reference": "EXT-CUSTOMER-REF-001",
  "name": "María",
  "lastname": "García",
  "email": "maria.garcia@example.com",
  "phone": "+56912345678",
  "identificationNumber": "12.345.678-9",
  "identificationNumberCountry": "CL",
  "createdDate": "2026-06-01T10:00:00.000Z",
  "addresses": [
    {
      "formattedAddress": "Av. Providencia 1234, Providencia, Región Metropolitana, Chile",
      "coordinates": {
        "lat": -33.4264,
        "lng": -70.6199
      }
    },
    {
      "formattedAddress": "Camino El Alba 8500, Las Condes, Región Metropolitana, Chile",
      "coordinates": null
    }
  ]
}

Error responses for this endpoint follow the shared error reference.

Purpose

Returns the full record of a single customer, identified by its Sodtrack id.

Unlike the customers search endpoint, which is meant to resolve and identify customers, this endpoint is the one that serves contact and identity data: email, phone, identification number and the addresses registered for the customer.

Only customers are exposed. Any other kind of Sodtrack user is treated as non-existent and returns 404 Not Found, even when the id exists in Sodtrack.

Field Definitions

📦 Path parameters

Field	Type	Required	Description
`customerId`	`number`	✅	Sodtrack id of the customer requested. Must be an integer.

This endpoint does not accept query parameters or a request body. Anything sent is ignored.

Example Request

code

GET /api/integration/customer/2001
x-api-key: <your-api-key>

Typical flow: resolve the customer first with the search endpoint — by identificationNumber, reference or phoneNumber — and then request its full record with the returned id.

code

GET /api/integration/customer/v2?reference=EXT-CUSTOMER-REF-001
GET /api/integration/customer/2001

Response Example

json

{
  "id": 2001,
  "reference": "EXT-CUSTOMER-REF-001",
  "name": "María",
  "lastname": "García",
  "email": "maria.garcia@example.com",
  "phone": "+56912345678",
  "identificationNumber": "12.345.678-9",
  "identificationNumberCountry": "CL",
  "createdDate": "2026-06-01T10:00:00.000Z",
  "addresses": [
    {
      "formattedAddress": "Av. Providencia 1234, Providencia, Región Metropolitana, Chile",
      "coordinates": {
        "lat": -33.4264,
        "lng": -70.6199
      }
    },
    {
      "formattedAddress": "Camino El Alba 8500, Las Condes, Región Metropolitana, Chile",
      "coordinates": null
    }
  ]
}

Response Fields

🧍 Customer

Field	Type	Description
`id`	`number`	Unique Sodtrack identifier of the customer.
`reference`	`string	null`
`name`	`string	null`
`lastname`	`string	null`
`email`	`string`	Email address. Always present and unique in Sodtrack.
`phone`	`string	null`
`identificationNumber`	`string	null`
`identificationNumberCountry`	`string	null`
`createdDate`	`string`	ISO 8601 timestamp of creation.
`addresses`	`array`	Addresses registered for the customer. Empty when the customer has none.

🏠 Address — `addresses[]`

Field	Type	Description
`formattedAddress`	`string	null`
`coordinates`	`object	null`
`coordinates.lat`	`number`	Latitude.
`coordinates.lng`	`number`	Longitude.

Error Responses

HTTP Status	Error	Description
`400 Bad Request`	`InvalidParameters`	`customerId` is not a valid integer.
`401 Unauthorized`	—	`x-api-key` is missing or invalid, or the request does not reach Sodtrack through the authorized network.
`404 Not Found`	`CUSTOMER_NOT_FOUND: {customerId}`	No customer exists with that id, or the id belongs to a Sodtrack user that is not a customer.
`500 Internal Server Error`	—	Unexpected server error. Contact Sodtrack support.

Business Rules & Constraints

Customers only

The endpoint serves customer records exclusively. An id belonging to a provider or to any other internal Sodtrack user returns 404 Not Found, with no indication that the id exists. Use it only with ids obtained from customer-oriented endpoints.

Addresses

addresses lists every address registered for the customer, without pagination and without a defined order.

A customer with no registered addresses returns addresses: [].
coordinates is null when the address was stored without geolocation.

Returned data

Timestamps are ISO 8601 in UTC.
Optional fields that were never set are returned as null, not omitted.
identificationNumber is returned exactly as stored, which may include separators such as dots or dashes. When searching by identification number, the search endpoint normalizes separators for you.