API Reference

Authentication

Pass your API key as a bearer token. Generate keys in your vendor dashboard.

curl https://amavest.org/api/v1/disputes \
  -H "Authorization: Bearer sk_live_..."

List disputes

GET /disputes

Returns a paginated list of disputes across all your connected Stripe accounts.

{
  "data": [
    {
      "id": "dp_abc123",
      "stripe_dispute_id": "dp_1M...",
      "reason_code": "13.1",
      "status": "needs_response",
      "amount_cents": 8500,
      "currency": "usd",
      "due_by": "2026-08-01T00:00:00Z",
      "ai_review": { "confidence": 0.82, "recommendation": "challenge" }
    }
  ],
  "has_more": false
}

Submit evidence

POST /disputes/:id/submit

Triggers Amavest to compile evidence and submit to Stripe. Idempotent.

curl -X POST https://amavest.org/api/v1/disputes/dp_abc123/submit \
  -H "Authorization: Bearer sk_live_..."

Webhooks

Configure an endpoint to receive events. Every payload is HMAC-signed with your webhook secret.

• · dispute.created
• · dispute.submitted
• · dispute.won
• · dispute.lost

Errors

Standard HTTP status codes. Errors return { "error": { "code", "message" } }.