Skip to main content
GET
/
api
/
partner
/
v2
/
banks
/
users
/
{userId}
/
accounts
cURL
curl --request GET \
  --url https://staging-api.capa.fi/api/partner/v2/banks/users/{userId}/accounts \
  --header 'partner-api-key: <partner-api-key>'
{
  "success": true,
  "data": {
    "count": 5,
    "total": 10,
    "data": [
      {
        "id": "<string>",
        "userId": "<string>",
        "accountNumber": "<string>",
        "clabe": "<string>",
        "isVerified": true,
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "partnerId": "<string>",
        "bankName": "<string>",
        "documentNumber": "<string>",
        "alias": "<string>",
        "verifiedAt": "2023-11-07T05:31:56Z"
      }
    ]
  }
}
Retrieves bank accounts for a user with pagination. Supports filtering by country, ramp type, or fetching a specific account by ID.

​
Error Codes

​
Common Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”API Key is missing”
401UNAUTHORIZED”Invalid API Key format”
401UNAUTHORIZED”Invalid API Key”
403INVALID_PARTNER_FLOW”The partner has an invalid flow.”

​
User Ownership Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”Partner information is required for this operation”
401UNAUTHORIZED”User is not associated with the partner”

​
Endpoint-Specific Errors

HTTP StatusCodeMessage
400INVALID_USER_INPUT_ERROR”Invalid User Input”

Headers

​
partner-api-key
string
required

Api key for the affiliated partner that is performing the request

Path Parameters

​
userId
string
required

The user ID to get bank info for

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

Query Parameters

​
country
enum<string>

Country filter

Available options:
MX,
DO,
US,
AT,
BE,
BG,
HR,
CY,
CZ,
DK,
EE,
FI,
FR,
DE,
GR,
HU,
IE,
IT,
LV,
LT,
LU,
MT,
NL,
PL,
PT,
RO,
SK,
SI,
ES,
SE,
IS,
LI,
NO,
CH,
GB,
MC,
SM,
AD,
VA,
CN
​
rampType
enum<string>

Ramp type filter (ON_RAMP or OFF_RAMP)

Available options:
ON_RAMP,
OFF_RAMP,
CROSS_RAMP
​
id
string

User bank info ID to fetch a specific bank account

​
skip
number

The number of elements to exclude from the results.

​
limit
number

The maximum amount of results to return.

​
sortBy
string

Supported values:

  • createdAt

Response

200 - application/json

Retrieves the bank accounts for a user by userId with pagination.

​
success
boolean
Example:

true

​
data
object