v1

latestOpenAPI 3.1.12026-07-2452287575.4 KB
Payment Methods

List Payment Methods

Returns a list of PaymentMethods that were previously created.

get/v1/companies/{company_id}/payment-methods

Path parameters

company_idstring uuid required
Example:8c581d79-bb84-4bc1-b1c5-8c073264a569

The Company ID.

Query parameters

archival_status'not_archived' | 'system' | 'team_member'

Filter by archival status. When omitted, no archival status filter is applied. NOTE: Filters for system and team_member-archived PaymentMethods can only return invalid PaymentMethods. Therefore, unless you also pass is_valid=false, its default, is_valid=true, will ensure you receive no returned PaymentMethods.

ValueDescription
not_archivedOnly active (non-archived) accounts.
systemOnly system-archived accounts (cannot be unarchived).
team_memberOnly accounts archived by a TeamMember (can be unarchived).
is_valid'all' | 'false' | 'true'

Filter by whether the PaymentMethod can be used for payments. Pass all to return all PaymentMethods regardless of validity.

ValueDescription
allFetch all PaymentMethods regardless of validity.
falseFetch only invalid PaymentMethods.
trueFetch only valid PaymentMethods.
pageinteger

Retrieve a specific page of a List.

page_sizeinteger

Set the number of results per page of a List.

verification_status'failed' | 'not_verified' | 'pending' | 'verified'

Filter by verification status.

ValueDescription
failedVerification failed.
not_verifiedAccounts not yet verified or not requiring verification.
pendingVerification in progress (micro-deposits pending).
verifiedSuccessfully verified accounts.

Response

OK

object'List' required

The object’s type (List).

Example response

{
  "results": [
    {
      "type_details": {
        "attention_line": "Attn: John Smith"
      }
    }
  ]
}