Skip to main content
GET
Search CoworkerPaymentMethods
A CoworkerPaymentMethod is a tokenised payment method stored against a customer and a location, used when charging invoices issued to that customer by that location. Currently supported providers are Stripe (card and ACH/BACS) and GoCardless (direct debit mandates). The RegularPaymentProvider field identifies the provider; valid values for this entity are Stripe (2), StripeACH (11), StripeBACS (13), and GoCardless (12).
  • For Stripe methods, MethodId holds the Stripe payment method ID and CustomerId holds the Stripe customer ID.
  • For GoCardless mandates, MandateId holds the GoCardless mandate ID and CustomerId holds the GoCardless customer ID.
  • CardNumber stores a masked card number for display purposes only.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the CoworkerPaymentMethod-List role.

Enums

Query Parameters

Pagination & Sorting

integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g. Name, CreatedOn).
integer
Sort direction. 0 for ascending, 1 for descending.

Filters

integer
Filter by customer this payment method belongs to.
integer
Filter by location that issued or will charge invoices using this payment method.
string
Filter by location name.
string
Filter by currency code of the location.
integer
Filter by payment provider for this method. For this entity, valid values are Stripe (2), StripeACH (11), StripeBACS (13), and GoCardless (12)..
string
Filter by provider payment method ID (e.g. Stripe payment method ID).
string
Filter by provider customer ID (e.g. Stripe or GoCardless customer ID).
string
Filter by goCardless mandate ID. Only populated for GoCardless payment methods..
string
Filter by masked card number for display purposes only.
string
Filter by optional notes about this payment method.

Range Filters

string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

Filtering by CreatedOn

Range filters

Response

200

CoworkerPaymentMethod[]
The list of CoworkerPaymentMethod records matching the query. See the Get one CoworkerPaymentMethod endpoint for the full list of properties returned for each record.
Partial records — The listing endpoint returns a summary representation of each CoworkerPaymentMethod. The following fields are not populated in the Records[] response: RegularPaymentProvider.To get all fields, fetch the full record using the Get one CoworkerPaymentMethod endpoint.Important for updates: When updating a record via PUT, always retrieve the full record with a GET request first, apply your changes to that complete data, and then send the updated record. Do not use data from a listing response as the base for a PUT request, as missing fields may be unintentionally cleared.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (0 = ascending, 1 = descending).
integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response