---
title: "List outbound payment imports"
method: GET
path: "/outbound_payment_imports"
tags: ["Outbound Payment Import"]
---

# List outbound payment imports

`GET /outbound_payment_imports`

## Request

- Base URL: `https://api.gocardless.com`
- URL: `https://api.gocardless.com/outbound_payment_imports`
- Auth: HTTP bearer

Returns a [cursor-paginated](https://docs.gocardless.com/docs/api-reference/data-conventions#cursor-pagination) list of your outbound payment imports.

## Query parameters

- `before` string, nullable
- `after` string, nullable
- `limit` union
  - integer
  - string
- `created_at` object
  - `gt` string, date-time: Limit to records created after the specified date-time.
  - `lt` string, date-time: Limit to records created before the specified date-time.
  - `gte` string, date-time: Limit to records created on or after the specified date-time.
  - `lte` string, date-time: Limit to records created on or before the specified date-time.
- `status` 'created' | 'validating' | 'valid' | 'invalid' | 'processing' | 'processed' | 'cancelled': The status of the outbound payment import. - `created`: The initial state of a new import. - `validating`: Import validation in progress. - `invalid`: Import validation failed. - `valid`: Import validation succeeded. - `processing`: Authorisation received; payments are being generated. - `processed`: All entries have been successfully converted into outbound payments. - `cancelled`: The import was cancelled by a user or automatically expired by the system.

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- OutboundPaymentImportMultiResourceResponse
  - `outbound_payment_imports` OutboundPaymentImport[]
    - `id` string, required: Unique identifier, beginning with "IM".
    - `created_at` string, date-time: Fixed [timestamp](https://docs.gocardless.com/docs/api-reference/data-conventions#dates-and-times), recording when this resource was created.
    - `status` 'created' | 'validating' | 'valid' | 'invalid' | 'processing' | 'processed' | 'cancelled': The status of the outbound payment import. - `created`: The initial state of a new import. - `validating`: Import validation in progress. - `invalid`: Import validation failed. - `valid`: Import validation succeeded. - `processing`: Authorisation received; payments are being generated. - `processed`: All entries have been successfully converted into outbound payments. - `cancelled`: The import was cancelled by a user or automatically expired by the system.
    - `amount_sum` integer: The sum of all import entry amounts, in the lowest denomination for the currency (e.g. pence in GBP, cents in EUR).
    - `currency` 'GBP': [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) currency. Currently only "GBP" is supported.
    - `authorisation_url` string: The link to the GoCardless dashboard to review and authorise the import
    - `entry_counts` OutboundPaymentImportEntryCounts
      - `total` integer: The total number of entries included in the import.
      - `valid` integer: Count of entries that passed validation checks.
      - `invalid` integer: Count of entries that failed validation checks.
      - `processed` integer: Count of entries successfully converted into outbound payments after the import was authorised.
      - `failed_to_process` integer: Count of entries that encountered a terminal error during the outbound payment generation process.
      - `verified` integer: Total count of entries checked against bank account holder verification services (e.g., CoP).
      - `verified_with_full_match` integer: Count of entries where the account holder name was a direct match.
      - `verified_with_partial_match` integer: Count of entries where the account holder name was a close match.
      - `verified_with_no_match` integer: Count of entries where the account holder name did not match the records.
      - `verified_with_unable_to_match` integer: Count of entries where the verification service could not return a definitive result.
    - `links` OutboundPaymentImportLinks
      - `creditor` string: ID of the creditor who sends the outbound payments from the import.
  - `meta` OutboundPaymentImportPaginationMeta: Cursor pagination information
    - `limit` integer, required
    - `cursors` object, required
      - `before` string, nullable, required: Cursor pointing to the end of the desired set.
      - `after` string, nullable, required: Cursor pointing to the start of the desired set.

## Other responses

- `400`: Bad Request
- `401`: Unauthorised
- `404`: Not found
- `422`: Validation Error
- `500`: Internal Error

---

[API](https://skmtc.dev/gocardless/apis/gocardless-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-api/revisions/4dd3dae45364?raw)