List customers

Lists counterparty customers for the resolved workspace — the top of the Customer → Engagement → Project ownership hierarchy. Identity only: no financials, rates, or contract terms.

GET/api/v1/customers

Authorization

engagements:readapi key scoperequired

Required scope when calling with an API key.

Query parameters

querystringoptional

Case-insensitive match against customer name

Example: Acme

limitnumberoptional

Maximum rows, clamped to 1–100

Example: 25

Request

GET /api/v1/customers

curl -X GET "https://www.digitalstack360.com/api/v1/customers" \
  -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"
    }
  ],
  "meta": {
    "count": 1,
    "truncated": false
  }
}

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