---
title: "List payment methods"
method: GET
path: "/companies/{companyId}/data/paymentMethods"
tags: ["Payment methods"]
---

# List payment methods

`GET /companies/{companyId}/data/paymentMethods`

The *List payment methods* endpoint returns a list of [payment methods](https://docs.codat.io/sync-for-payables-api#/schemas/PaymentMethod) for a given company's connection.

[Payment methods](https://docs.codat.io/sync-for-payables-api#/schemas/PaymentMethod) are used to pay a Bill. Payment Methods are referenced on [Bill Payments](https://docs.codat.io/sync-for-payables-api#/schemas/BillPayment) and [Payments](https://docs.codat.io/sync-for-payables-api#/schemas/Payment).

Before using this endpoint, you must have [retrieved data for the company](https://docs.codat.io/sync-for-payables-api#/operations/refresh-company-data).

## Query parameters

- `page` integer
- `pageSize` integer
- `query` string
- `orderBy` string

## Response `200`

Success

- PaymentMethods — unresolved $ref

## Other responses

- `400` — Your `query` parameter was not correctly formed
- `401` — Your API request was not properly authorized.
- `402` — An account limit has been exceeded. The type of limit is described in the error property: - You have exceeded the 50-company limit that applies to a Free plan. Delete any companies you no longer need and retry the request. - The requested sync schedule is not allowed. You requested an hourly sync schedule but this functionality is not included in the Free plan. - Your Free account is older than 365 days and has expired. Contact support@codat.io.
- `403` — You are using an outdated API key or a key not associated with that resource.
- `404` — One or more of the resources you referenced could not be found. This might be because your company or data connection id is wrong, or was already deleted.
- `409` — The data type's dataset has not been requested or is still syncing.
- `429` — Too many requests were made in a given amount of time. Wait a short period and then try again.
- `500` — There is a problem with our server. Please try again later.
- `503` — The Codat API is temporarily offline for maintenance. Please try again later.

## Changes

> 52 revisions in range; 1 could not be searched.

- **2024-09-10** (v1) `5a2a77c169ea` — 4 info
  - added `#/components/schemas/created` to the `allOf[subschema #1]/results/items/allOf[subschema #2: Modified dates]/allOf[subschema #1: ModifiedDate]/modifiedDate` response property `allOf` list for the response status `200`
  - added `#/components/schemas/created` to the `allOf[subschema #1]/results/items/allOf[subschema #2: Modified dates]/allOf[subschema #2: Source Modified Date]/sourceModifiedDate` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/created` from the `allOf[subschema #1]/results/items/allOf[subschema #2: Modified dates]/allOf[subschema #1: ModifiedDate]/modifiedDate` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/created` from the `allOf[subschema #1]/results/items/allOf[subschema #2: Modified dates]/allOf[subschema #2: Source Modified Date]/sourceModifiedDate` response property `allOf` list for the response status `200`

[Change history](https://skmtc.dev/codatio/apis/sync-for-payables/changes/companies/:companyId/data/paymentMethods/get.md)

---

[API](https://skmtc.dev/codatio/apis/sync-for-payables.md) · [All operations](https://skmtc.dev/codatio/apis/sync-for-payables/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/codatio/sync-for-payables/revisions/06163dffa75f/schema)