List payment methods

Beta

GET

/v2/payment-methods

GET

/api/v2/payment-methods

curl -G https://api-sandbox.payabli.com/api/v2/payment-methods \
     -H "Authorization: Bearer <token>" \
     -d limit=1 \
     -d page=1

{
  "success": true,
  "message": "Payment methods retrieved successfully",
  "traceId": "0HNNN6HH5NE0R:00000014",
  "data": {
    "data": [
      {
        "paymentMethodReference": "019ff142-454b-7721-96a3-c8628b9d568f",
        "type": "bank_account",
        "accountOwner": "019fed1a-3d6e-75d3-a81e-cba3874b0a55",
        "ownerType": "business",
        "status": "PENDING",
        "createdAt": "2026-08-11T14:38:00.011776",
        "lastUpdated": "2026-08-11T14:38:00.011776",
        "_links": {
          "self": "/api/v2/payment-methods/019ff142-454b-7721-96a3-c8628b9d568f",
          "owner": "/api/v2/businesses/019fed1a-3d6e-75d3-a81e-cba3874b0a55"
        },
        "isDefault": false,
        "nickname": "Operating account",
        "financialInstitution": "Bank of Example",
        "accountType": "Checking",
        "accountNumber": "****6789",
        "routingNumber": "*****0021",
        "usage": [
          "deposits",
          "billing"
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "totalPages": 1,
      "totalRecords": 1,
      "pageSize": 1,
      "hasNext": false,
      "hasPrevious": false
    }
  }
}

Lists payment methods with optional filtering and pagination.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

accountOwnerstringOptional

Filter by the entity that owns the payment method.

ownerTypeenumOptional

Filter by owner type.

Allowed values:

statusstringOptional

Filter by payment method status.

typestringOptional

Filter by payment method type.

limitintegerOptional

Number of results per page.

pageintegerOptional

Page number to return.

sortBystringOptional

Field to sort by.

sortOrderstringOptional

Sort direction.

Response

A page of payment methods.

successboolean

Whether the request succeeded.

messagestring or null

A human-readable result message.

traceIdstring or null

The trace identifier for the request, useful for support.

dataobject or null

The page of payment methods.

Errors

401

Unauthorized Error

500

Internal Server Error