Astrocal
API ReferencePaymentsV1Payments

List payments

Returns a paginated list of payments for the organization. Supports optional status filtering and cursor-based pagination.

GET
/v1/payments

Authorization

BearerAuth
AuthorizationBearer <token>

API key authentication. Use your API key as the bearer token.

In: header

Query Parameters

status?string
Value in"pending" | "succeeded" | "failed" | "refunded"
starting_after?string
limit?integer
Default20
Range1 <= value <= 100

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/payments"
{
  "data": [
    {
      "id": "string",
      "booking_id": "string",
      "stripe_payment_intent_id": "string",
      "amount": 0,
      "currency": "string",
      "platform_fee": 0,
      "status": "pending",
      "refund_id": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "has_more": true
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Update organization

Updates an organization's name and/or slug. Service key authentication required. Called by the dashboard settings page.

Get payment summary

Returns aggregated payment metrics for the organization: total revenue, platform fees, total refunded, and pending count. All monetary amounts are in cents.