Retrieve a customer

Retrieves one customer by id. A customer outside the credential workspace returns 404 — indistinguishable from a missing one.

GET/api/v1/customers/:id

Authorization

engagements:readapi key scoperequired

Required scope when calling with an API key.

Path parameters

idstringrequired

Customer UUID

Example: cust_abc123

Request

GET /api/v1/customers/:id

curl -X GET "https://www.digitalstack360.com/api/v1/customers/cust_abc123" \
  -H "Authorization: Bearer $DS_API_KEY"

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": {
    "id": "cust_abc123",
    "name": "Acme Corp",
    "display_name": "Acme",
    "jurisdiction": null,
    "external_customer_ref": null,
    "created_at": "2026-07-01T00:00:00Z",
    "updated_at": "2026-07-15T14:22:04Z"
  }
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks engagements:read scope

404

not_found

Customer does not exist in the credential workspace