curl --request GET \
--url https://api.wellapp.ai/v1/payment-means \
--header 'Authorization: <authorization>'{
"data": [
{
"type": "payment_means",
"attributes": {
"type": "account_details",
"scheme": "ACH",
"status": "active",
"account_details": {
"account_number": "1234567890",
"routing_number": "021000021",
"account_type": "checking",
"currency": "USD"
},
"bank_details": {
"bank_name": "JPMorgan Chase Bank, N.A.",
"bank_code": "CHASUS33",
"branch_name": "New York Main Branch",
"branch_code": "NY001"
},
"compliance": {
"kyc_status": "verified",
"aml_status": "cleared"
},
"nickname": "US Operating Account",
"description": "Primary USD account for US operations",
"tags": [
"usd",
"operating",
"us",
"primary"
]
},
"relationships": {
"holder": {
"data": {
"type": "company",
"id": "holder-company-1"
}
},
"account_location": {
"data": {
"type": "location",
"id": "bank-location-1"
}
},
"holder_location": {
"data": {
"type": "location",
"id": "holder-location-1"
}
},
"bank": {
"data": {
"type": "company",
"id": "bank-company-1"
}
},
"intermediary_banks": {
"data": [
{
"type": "company",
"id": "intermediary-bank-1"
}
]
},
"ultimate_beneficiary": {
"data": {
"type": "people",
"id": "beneficiary-person-1"
}
},
"created_by": {
"data": {
"type": "people",
"id": "creator-person-1"
}
},
"documents": {
"data": [
{
"type": "document",
"id": "bank-statement-1"
},
{
"type": "document",
"id": "verification-letter-1"
}
]
},
"transactions": {
"data": [
{
"type": "transaction",
"id": "recent-transaction-1"
}
]
},
"linked_payment_means": {
"data": [
{
"type": "payment_means",
"id": "corporate-card-1"
}
]
}
},
"included": [
{
"type": "company",
"id": "holder-company-1",
"attributes": {
"name": "ACME Corporation",
"description": "Technology solutions provider",
"registration": {
"registered_name": "ACME Corporation Inc.",
"trade_name": "ACME"
},
"tax_id": {
"value": "12-3456789",
"type": "EIN"
}
}
},
{
"type": "location",
"id": "bank-location-1",
"attributes": {
"street": "270 Park Avenue",
"city": "New York",
"state": "NY",
"postal_code": "10017",
"country": "US",
"is_primary": true
}
},
{
"type": "location",
"id": "holder-location-1",
"attributes": {
"street": "123 Business Avenue",
"city": "New York",
"state": "NY",
"postal_code": "10001",
"country": "US",
"is_primary": true
}
},
{
"type": "company",
"id": "bank-company-1",
"attributes": {
"name": "JPMorgan Chase Bank",
"description": "Major US financial institution",
"registration": {
"registered_name": "JPMorgan Chase Bank, N.A."
},
"tax_id": {
"value": "13-2624428",
"type": "EIN"
}
}
},
{
"type": "company",
"id": "intermediary-bank-1",
"attributes": {
"name": "Wells Fargo Bank",
"description": "Intermediary bank for routing",
"registration": {
"registered_name": "Wells Fargo Bank, N.A."
}
}
},
{
"type": "people",
"id": "beneficiary-person-1",
"attributes": {
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"date_of_birth": "1980-05-15"
}
},
{
"type": "people",
"id": "creator-person-1",
"attributes": {
"first_name": "John",
"last_name": "Smith",
"full_name": "John Smith"
}
},
{
"type": "document",
"id": "bank-statement-1",
"attributes": {
"name": "Bank Statement January 2025.pdf",
"file_size": 245678,
"content_type": "application/pdf"
}
},
{
"type": "document",
"id": "verification-letter-1",
"attributes": {
"name": "Account Verification Letter.pdf",
"file_size": 123456,
"content_type": "application/pdf"
}
},
{
"type": "transaction",
"id": "recent-transaction-1",
"attributes": {
"amount": {
"value": 5000,
"currency": "USD"
},
"description": "Monthly supplier payment",
"transaction_date": "2025-01-15T00:00:00.000Z",
"status": "completed"
}
},
{
"type": "payment_means",
"id": "corporate-card-1",
"attributes": {
"type": "card",
"nickname": "Corporate Visa Card",
"scheme": "visa",
"status": "active",
"card_details": {
"last_four": "1234",
"expiry_month": 12,
"expiry_year": 2026,
"cardholder_name": "ACME CORPORATION"
}
}
}
]
}
],
"meta": {
"pagination": {
"total": 1,
"count": 1,
"per_page": 25,
"current_page": 1,
"total_pages": 1
}
}
}Retrieve a list of payment methods and accounts with advanced filtering, sorting, and include capabilities. This endpoint supports:
Default behavior: Returns payment means with basic information (IDs only for relationships).
Include functionality: Use the include parameter to get detailed relationship data.
Date filtering: Filter by creation, update, or deletion date ranges.
Relationship filtering: Filter by related entities using various identifiers.
Payment filtering: Filter by payment type, scheme, status, and compliance.
Financial filtering: Filter by currency, bank details, and verification status.
Sorting: Sort results by date fields in ascending or descending order.
Pagination: Supports cursor-based pagination for large datasets.
curl --request GET \
--url https://api.wellapp.ai/v1/payment-means \
--header 'Authorization: <authorization>'{
"data": [
{
"type": "payment_means",
"attributes": {
"type": "account_details",
"scheme": "ACH",
"status": "active",
"account_details": {
"account_number": "1234567890",
"routing_number": "021000021",
"account_type": "checking",
"currency": "USD"
},
"bank_details": {
"bank_name": "JPMorgan Chase Bank, N.A.",
"bank_code": "CHASUS33",
"branch_name": "New York Main Branch",
"branch_code": "NY001"
},
"compliance": {
"kyc_status": "verified",
"aml_status": "cleared"
},
"nickname": "US Operating Account",
"description": "Primary USD account for US operations",
"tags": [
"usd",
"operating",
"us",
"primary"
]
},
"relationships": {
"holder": {
"data": {
"type": "company",
"id": "holder-company-1"
}
},
"account_location": {
"data": {
"type": "location",
"id": "bank-location-1"
}
},
"holder_location": {
"data": {
"type": "location",
"id": "holder-location-1"
}
},
"bank": {
"data": {
"type": "company",
"id": "bank-company-1"
}
},
"intermediary_banks": {
"data": [
{
"type": "company",
"id": "intermediary-bank-1"
}
]
},
"ultimate_beneficiary": {
"data": {
"type": "people",
"id": "beneficiary-person-1"
}
},
"created_by": {
"data": {
"type": "people",
"id": "creator-person-1"
}
},
"documents": {
"data": [
{
"type": "document",
"id": "bank-statement-1"
},
{
"type": "document",
"id": "verification-letter-1"
}
]
},
"transactions": {
"data": [
{
"type": "transaction",
"id": "recent-transaction-1"
}
]
},
"linked_payment_means": {
"data": [
{
"type": "payment_means",
"id": "corporate-card-1"
}
]
}
},
"included": [
{
"type": "company",
"id": "holder-company-1",
"attributes": {
"name": "ACME Corporation",
"description": "Technology solutions provider",
"registration": {
"registered_name": "ACME Corporation Inc.",
"trade_name": "ACME"
},
"tax_id": {
"value": "12-3456789",
"type": "EIN"
}
}
},
{
"type": "location",
"id": "bank-location-1",
"attributes": {
"street": "270 Park Avenue",
"city": "New York",
"state": "NY",
"postal_code": "10017",
"country": "US",
"is_primary": true
}
},
{
"type": "location",
"id": "holder-location-1",
"attributes": {
"street": "123 Business Avenue",
"city": "New York",
"state": "NY",
"postal_code": "10001",
"country": "US",
"is_primary": true
}
},
{
"type": "company",
"id": "bank-company-1",
"attributes": {
"name": "JPMorgan Chase Bank",
"description": "Major US financial institution",
"registration": {
"registered_name": "JPMorgan Chase Bank, N.A."
},
"tax_id": {
"value": "13-2624428",
"type": "EIN"
}
}
},
{
"type": "company",
"id": "intermediary-bank-1",
"attributes": {
"name": "Wells Fargo Bank",
"description": "Intermediary bank for routing",
"registration": {
"registered_name": "Wells Fargo Bank, N.A."
}
}
},
{
"type": "people",
"id": "beneficiary-person-1",
"attributes": {
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"date_of_birth": "1980-05-15"
}
},
{
"type": "people",
"id": "creator-person-1",
"attributes": {
"first_name": "John",
"last_name": "Smith",
"full_name": "John Smith"
}
},
{
"type": "document",
"id": "bank-statement-1",
"attributes": {
"name": "Bank Statement January 2025.pdf",
"file_size": 245678,
"content_type": "application/pdf"
}
},
{
"type": "document",
"id": "verification-letter-1",
"attributes": {
"name": "Account Verification Letter.pdf",
"file_size": 123456,
"content_type": "application/pdf"
}
},
{
"type": "transaction",
"id": "recent-transaction-1",
"attributes": {
"amount": {
"value": 5000,
"currency": "USD"
},
"description": "Monthly supplier payment",
"transaction_date": "2025-01-15T00:00:00.000Z",
"status": "completed"
}
},
{
"type": "payment_means",
"id": "corporate-card-1",
"attributes": {
"type": "card",
"nickname": "Corporate Visa Card",
"scheme": "visa",
"status": "active",
"card_details": {
"last_four": "1234",
"expiry_month": 12,
"expiry_year": 2026,
"cardholder_name": "ACME CORPORATION"
}
}
}
]
}
],
"meta": {
"pagination": {
"total": 1,
"count": 1,
"per_page": 25,
"current_page": 1,
"total_pages": 1
}
}
}curl -X GET "https://api.well.com/v1/payment-means?include=holder,account_location,bank,documents&filter[type]=account_details,card_details&filter[scheme]=SEPA,VISA&filter[status]=active&filter[holder_id]=550e8400-e29b-41d4-a716-446655440001&filter[currency]=EUR&filter[kyc_status]=verified&filter[aml_status]=compliant&filter[is_verified]=true&filter[created_at][from]=2025-01-01T00:00:00Z&filter[created_at][to]=2025-12-31T23:59:59Z&sort=-created_at&page[limit]=25&page[cursor]=eyJjcmVhdGVkX2F0IjoiMjAyNS0xMS0wMlQxMDozMDowMFoiLCJpZCI6InBtLXV1aWQifQ==" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
Bearer token for authentication
Comma-separated list of related resources to include with detailed attributes. Available options: holder, account_location, holder_location, bank, intermediary_banks, ultimate_beneficiary, created_by, documents, transactions, linked_payment_means
Filter payment means created on or after this datetime (ISO 8601 format)
Filter payment means created on or before this datetime (ISO 8601 format)
Filter payment means updated on or after this datetime (ISO 8601 format)
Filter payment means updated on or before this datetime (ISO 8601 format)
Filter by payment means type. See payment means types for details.
card_details, account_details, wallet_details, cash_details, check_details, crypto_details, other Filter by payment scheme or network. See scheme types for details.
SEPA, SWIFT, ACH, FASTER_PAYMENTS, VISA, MASTERCARD, AMEX, PAYPAL, APPLEPAY, GOOGLEPAY, STRIPE, LOCAL, OTHER Filter by payment means status. See payment means status for details.
active, inactive, pending_verification, suspended, expired, blocked, failed_verification, pending_removal, removed, archived Filter by currency code (ISO 4217)
Filter by holder ID (company or person)
Filter by holder type
company, people Filter by banking institution ID
Filter by bank name (partial match)
Filter by IBAN (exact match)
Filter by BIC/SWIFT code (exact match)
Filter by account number (partial match)
Filter by routing number (US ACH)
Filter by card brand
visa, mastercard, amex, discover, diners, jcb, unionpay, other Filter by card type
credit, debit, prepaid, charge Filter by digital wallet provider
paypal, applepay, googlepay, stripe, square, venmo, cashapp, other Filter by primary payment means status
Filter by verification status
Filter by KYC verification status
pending, in_progress, completed, failed, not_required Filter by AML check status
pending, in_progress, cleared, flagged, not_required Filter by sanctions screening status
pending, passed, failed, not_required Filter by account location ID
Filter by holder location ID
Filter by creator user ID
Filter by workspace ID
Filter by external workspace identifier
Filter by nickname (partial match)
Filter by tags (comma-separated)
Sort payment means by fields. Prefix with '-' for descending order. Available fields: created_at, updated_at, nickname, status, scheme, type
Number of payment means to return per page (1-100)
1 <= x <= 100Cursor for pagination to get the next page of results
Payment means retrieved successfully
Show child attributes
"payment_means"Show child attributes
Type of payment means. See payment means types for details.
card_details, account_details, wallet_details, cash_details, check_details, crypto_details, other Payment scheme or network. See scheme types for details.
SEPA, SWIFT, ACH, FASTER_PAYMENTS, VISA, MASTERCARD, AMEX, PAYPAL, APPLEPAY, GOOGLEPAY, STRIPE, LOCAL, OTHER Current status of the payment means. See payment means status for details.
active, inactive, pending_verification, suspended, expired, blocked Bank account details for account_details type
Show child attributes
International Bank Account Number
Bank Identifier Code (SWIFT)
Local account number (alternative to IBAN)
Bank routing number (US ACH)
Currency code (ISO 4217)
Additional bank information
Credit/debit card details for card_details type
Show child attributes
Masked Primary Account Number (PCI DSS compliant)
Card brand
visa, mastercard, amex, discover, diners, jcb, unionpay, other Type of card
credit, debit, prepaid, charge Card expiry month
Card expiry year
Name as printed on card
Digital wallet details for wallet_details type
Show child attributes
Digital wallet provider
paypal, applepay, googlepay, stripe, square, venmo, cashapp, other Wallet identifier (email, phone, etc.)
Type of wallet account
personal, business, merchant Compliance and verification status
Show child attributes
Know Your Customer verification status
pending, in_progress, completed, failed, not_required Anti-Money Laundering check status
pending, in_progress, cleared, flagged, not_required Sanctions screening status
pending, passed, failed, not_required Last compliance check timestamp
User-friendly name for the payment means
Additional description of the payment means
Tags for categorization
Creation timestamp
Last update timestamp
Show child attributes
Ultimate beneficial owner if different from holder
Show child attributes
Account/payment method owner (required)
Show child attributes
Show child attributes
"people"UUID of the person
Show child attributes
The person's first name
The person's last name
The person's full name (typically first_name + last_name)
Timestamp when the person was created
Timestamp when the person was last updated
Locations/addresses associated of the account
Show child attributes
Show child attributes
"location"ID of the location
Show child attributes
Complete formatted address
Primary address line
Secondary address line
City name
State, province, or region
Postal or ZIP code
Two-letter ISO country code
Geographic latitude coordinate
Geographic longitude coordinate
Whether this is the primary location
Whether this is a registered business address
Custom label for the location
Date and time when the location was created
Date and time when the location was last updated
Locations/addresses associated of the holder
Show child attributes
Show child attributes
"location"ID of the location
Show child attributes
Complete formatted address
Primary address line
Secondary address line
City name
State, province, or region
Postal or ZIP code
Two-letter ISO country code
Geographic latitude coordinate
Geographic longitude coordinate
Whether this is the primary location
Whether this is a registered business address
Custom label for the location
Date and time when the location was created
Date and time when the location was last updated
bank
Show child attributes
Show child attributes
"company"UUID of the parent company
Show child attributes
The domain url from the website or email address of the company. Used as unique identifier in some cases.
500Show child attributes
Legal entity structure type.
Official company registration number.
Name of the official registration body.
Country of the registry authority. (string (ISO 3166-1 alpha-2))
UUID of the workspace associated with this company
Correspondent/intermediary banks for routing (optional)
Show child attributes
Show child attributes
"company"UUID of the parent company
Show child attributes
The domain url from the website or email address of the company. Used as unique identifier in some cases.
500Show child attributes
Legal entity structure type.
Official company registration number.
Name of the official registration body.
Country of the registry authority. (string (ISO 3166-1 alpha-2))
UUID of the workspace associated with this company
Ultimate beneficial owner if different from holder (optional)
Show child attributes
Show child attributes
"people"UUID of the person
Show child attributes
The person's first name
The person's last name
The person's full name (typically first_name + last_name)
Timestamp when the person was created
Timestamp when the person was last updated
Person who created this company
Show child attributes
Show child attributes
"people"UUID of the person
Show child attributes
The person's first name
The person's last name
The person's full name (typically first_name + last_name)
Timestamp when the person was created
Timestamp when the person was last updated
Supporting documents (statements, verifications) (optional)
Show child attributes
Show child attributes
"document"UUID of the document
Show child attributes
Supporting documents (statements, verifications) (optional)
Show child attributes
Show child attributes
"document"UUID of the document
Show child attributes
Payment scheme used for the transaction
sepa, swift, ach, faster_payments, instant_credit_transfer Show child attributes
External transaction identifier from payment provider
Payment request identifier
End-to-end reference for tracing the transaction
Date when transaction execution was requested
Timestamp when transaction was executed
Date when transaction was booked
Value date of the transaction
Show child attributes
Exchange rate applied
Currency pair (e.g., EURUSD)
Source of the exchange rate
Timestamp when exchange rate was applied
Type of transaction. See transaction types documentation for complete list.
payment, transfer, deposit, withdrawal, card_payment, direct_debit, refund, fee, interest, other Current status of the transaction
pending, completed, failed, cancelled, rejected ISO 20022 category purpose code
ISO 20022 purpose code
Show child attributes
Unstructured remittance information
Structured creditor reference
Type of structured reference. See remittance reference types for details.
SCOR, RADM, RPIN, FXDR, DISP, PUOR, SCNR Show child attributes
Type of fee. See banking transaction fees for details.
transfer_fee, exchange_fee, processing_fee, commission Fee amount
x >= 0ISO 4217 currency code
Timestamp when transaction was created
Timestamp when transaction was last updated
Supporting documents (statements, verifications) (optional)
Show child attributes
Show child attributes
"document"UUID of the document
Show child attributes
Type of payment means. See payment means types for details.
card_details, account_details, wallet_details, cash_details, check_details, crypto_details, other Payment scheme or network. See scheme types for details.
SEPA, SWIFT, ACH, FASTER_PAYMENTS, VISA, MASTERCARD, AMEX, PAYPAL, APPLEPAY, GOOGLEPAY, STRIPE, LOCAL, OTHER Current status of the payment means. See payment means status for details.
active, inactive, pending_verification, suspended, expired, blocked Bank account details for account_details type
Show child attributes
International Bank Account Number
Bank Identifier Code (SWIFT)
Local account number (alternative to IBAN)
Bank routing number (US ACH)
Currency code (ISO 4217)
Additional bank information
Show child attributes
Name of the bank
Bank code or identifier
Bank branch name
Bank branch code
Credit/debit card details for card_details type
Show child attributes
Masked Primary Account Number (PCI DSS compliant)
Card brand
visa, mastercard, amex, discover, diners, jcb, unionpay, other Type of card
credit, debit, prepaid, charge Card expiry month
Card expiry year
Name as printed on card
Digital wallet details for wallet_details type
Show child attributes
Digital wallet provider
paypal, applepay, googlepay, stripe, square, venmo, cashapp, other Wallet identifier (email, phone, etc.)
Type of wallet account
personal, business, merchant Compliance and verification status
Show child attributes
Know Your Customer verification status
pending, in_progress, completed, failed, not_required Anti-Money Laundering check status
pending, in_progress, cleared, flagged, not_required Sanctions screening status
pending, passed, failed, not_required Last compliance check timestamp
System metadata
User-friendly name for the payment means
Additional description of the payment means
Tags for categorization
Creation timestamp
Last update timestamp