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
starting_after?string
limit?integer

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, slug or default calendar. Send `complete_onboarding: true` to mark the first-login onboarding flow as done — the API sets the timestamp itself and repeat calls keep the first one. `mark_booking_link_shared`, `mark_availability_confirmed` and `dismiss_checklist` work the same way for the dashboard getting-started checklist, as does `mark_first_booking_celebrated` for the first-booking celebration. 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.