List saved cards

GET/v1/portal/saved-payment-methods

Coming March 2027

This endpoint ships in March 2027. The shape shown here can still change before release.

Returns the cards the client saved for this business's invoices.

A card is saved only when the client ticks "Save this card for future invoices" at Stripe checkout. The card stays at Stripe; we keep only Stripe's ids, the brand, the last four digits and the consent record. See Saved cards and auto-charge.

Permission: client scope
Type: Read-only. Changes nothing.
Auth: Client portal session
Capability: portal_list_saved_payment_methods
Available: From March 2027

portal_list_saved_payment_methods

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/portal/saved-payment-methods \
  --cookie 'fia_portal=<portal-session>'

{
  "data": [
    {
      "id": "0193f7a0-5b6c-7d7e-8f80-9a0b1c2d3e4f",
      "card_brand": "visa",
      "card_last4": "4242",
      "consent_text": "Save this card for future invoices from Studio North",
      "consent_at": "2027-03-02T12:00:00Z",
      "status": "active"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Authorizations

fia_portalcookierequired

Client portal session cookie set by open_portal_session.

Query Parameters

statusenum<string>default:active

Active or removed cards.

Available options: active, removed

limitintegerdefault:50

Page size, 1 to 200.

cursorstring

Cursor from the previous page's next_cursor.

Response

200 - application/json

dataobject[]

The saved cards on this page.

next_cursorstring | null

Cursor for the next page, or null on the last page.

has_moreboolean

Whether another page exists.

Errors

unauthenticated

Plus the common errors every call can return. See Errors.

Suggest edits Raise issue

Get the client statementPrevious Remove a saved cardNext

portal_list_saved_payment_methods

curl --request GET \
  --url https://api.freeinvoiceautomation.com/v1/portal/saved-payment-methods \
  --cookie 'fia_portal=<portal-session>'

{
  "data": [
    {
      "id": "0193f7a0-5b6c-7d7e-8f80-9a0b1c2d3e4f",
      "card_brand": "visa",
      "card_last4": "4242",
      "consent_text": "Save this card for future invoices from Studio North",
      "consent_at": "2027-03-02T12:00:00Z",
      "status": "active"
    }
  ],
  "next_cursor": null,
  "has_more": false
}