REST API Reference

The Declined REST API is available at https://dev.declined.io/api. All endpoints accept and return JSON. List endpoints support pagination via limit and starting_after query parameters.

Endpoints

Method	Path	Description
POST	/v1/events	Ingest billing and recovery events
GET	/v1/customers	List customers with recovery context
GET	/v1/recoveries	List recovery attempts
POST	/v1/recoveries/:id/mark-recovered	Mark a recovery attempt as successfully recovered
GET	/v1/sequences	List dunning sequences
GET	/v1/webhooks	List outbound webhook endpoints
GET	/v1/incentives	List incentive offers
GET	/v1/analytics	Recovery analytics summary

Pagination

json

{
  "data": [ ... ],
  "has_more": true,
  "next_cursor": "ra_abc123"
}

Marking recoveries

See the dedicated Recoveries guide for POST /v1/recoveries/:id/mark-recovered and the payment_recovered event type.

Rate limits

Event ingestion is optimized for high throughput. If you exceed workspace limits, responses include 429 with a Retry-After header.