Safestate
Distributor API

Overview of Distributor API

Distributor API

Use this section to access distributor-scoped endpoints.

Getting Started

Use the Distributor API when managing partner organizations, billing codes, distributor-level analytics, and event delivery (callback URLs and signing secrets). For HTTPS callback behaviour, see the Outbound webhooks reference.

Authentication

All /api/v1/distributors/... endpoints require:

HeaderDescription
SW-DISTRIBUTOR-IDYour unique distributor UUID
SW-API-KEYYour secret API key

Your distributor SW-API-KEY can also authenticate Partner API requests when used with a partner's SW-PARTNER-ID.

curl -X GET https://connect.safestate.com/api/v1/distributors/analytics \
  -H "SW-DISTRIBUTOR-ID: your-distributor-uuid" \
  -H "SW-API-KEY: your-api-key"

Insights

Distributor Analytics

View distributor-level performance and activity metrics.

Partner Management

Partners

List and create partner organizations under your distributor.

Partner Details

Retrieve, update, or offboard a specific partner.

Webhooks

Create a webhook endpoint

Register a new HTTPS webhook URL for the authenticated distributor scope.

Generate signing secret

Create a new signing secret for callback verification.

Cycle signing secret

Rotate active and fallback secrets.

Deactivate webhook signing secret DELETE

Deactivates an active or fallback signing secret by id for the authenticated partner organization.

Distributor analytics GET

Retrieve distributor-level analytics and reporting metrics.

On this page

Distributor APIGetting StartedAuthenticationInsightsPartner ManagementWebhooks