Safestate
Partner API

List partner customers

GET
/api/v1/integrations/partner/customers

Query Parameters

page?integer

Page number (1-based)

Default1
Range1 <= value
pageSize?integer

Number of customers per page (max 100)

Default20
Range1 <= value <= 100
status?string

Filter customers by status

Value in"active" | "inactive" | "dormant" | "prospect"

Header Parameters

SW-PARTNER-ID*string

Partner organization identifier

SW-API-KEY*string

API authentication key

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/integrations/partner/customers" \  -H "SW-PARTNER-ID: string" \  -H "SW-API-KEY: string"
{
  "success": true,
  "customers": [
    {
      "customerId": "550e8400-e29b-41d4-a716-446655440000",
      "status": "active"
    },
    {
      "customerId": "660e8400-e29b-41d4-a716-446655440001",
      "status": "inactive"
    }
  ],
  "pagination": {
    "totalCount": 42,
    "page": 1,
    "pageSize": 20,
    "hasNextPage": true
  }
}
{
  "success": false,
  "error": "Failed to verify org API key"
}
{
  "success": false,
  "error": "Partner ID and API key are required in headers"
}
{
  "success": false,
  "error": "Failed to list partner customers"
}