Get a subscription

GET /subscriptions/{id}

Retrieve details for a specific subscription by its ID.

Path parameters

id string(uuid) Required

Subscription ID (UUID)

Responses

200 application/json

Subscription details
Hide response attributes Show response attributes object
- id string(uuid)
  
  Unique subscription identifier
- target_url string(uri)
  
  The endpoint to which webhooks will be delivered
- secret string | null
  
  Secret used for HMAC signature verification (not returned in list views, only on get single if applicable)
- event_types string | null
  
  Comma-separated list of event types this subscription receives
- created_at string(date-time)
  
  Creation timestamp
- updated_at string(date-time)
  
  Last update timestamp
404 application/json

The requested resource was not found.
Hide response attribute Show response attribute object
- error string
500 application/json

An unexpected error occurred on the server.
Hide response attribute Show response attribute object
- error string

GET /subscriptions/{id}

curl \
 --request GET 'http://localhost:8080/subscriptions/{id}'

Response examples (200)

{
  "id": "c1f7c2e2-1234-4b6a-9c1e-abcdef123456",
  "created_at": "2025-05-12T12:00:00Z",
  "target_url": "https://webhook.site/your-url",
  "updated_at": "2025-05-12T12:00:00Z",
  "event_types": "order.created,user.updated"
}

Response examples (404)

{
  "error": "string"
}

Response examples (500)

{
  "error": "string"
}