---
title: "List all mandate import entries"
method: GET
path: "/mandate_import_entries"
tags: ["Mandate Import Entry"]
---

# List all mandate import entries

`GET /mandate_import_entries`

## Request

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

For an existing mandate import, this endpoint lists all of the entries attached.

After a mandate import has been submitted, you can use this endpoint to associate records
in your system (using the `record_identifier` that you provided when creating the
mandate import).

## Query parameters

- `before` string, nullable
- `after` string, nullable
- `limit` union
  - integer
  - string
- `mandate_import` string, required: Unique identifier, beginning with "IM".
- `status` 'successfully_processed' | 'unsuccessfully_processed': One of: - `successfully_processed`: the entry has been imported and the associated records created. - `unsuccessfully_processed`: the entry could not be processed due to an error, see the 'processing_errors' value

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- MandateImportEntryMultiResourceResponse
  - `mandate_import_entries` MandateImportEntry[]
    - `record_identifier` string, nullable, required: A unique identifier for this entry, which you can use (once the import has been processed by GoCardless) to identify the records that have been created. Limited to 255 characters.
    - `created_at` string, date-time, required: Fixed [timestamp](https://docs.gocardless.com/docs/api-reference/data-conventions#dates-and-times), recording when this resource was created.
    - `links` MandateImportEntryLinks, required: Related resources
      - `mandate_import` string, required: The ID of the mandate import. This is returned when you [create a Mandate Import](https://docs.gocardless.com/docs/api-reference/mandate-import#create-a-new-mandate-import).
      - `mandate` string: The ID of the mandate which was created when the mandate import was processed.
      - `customer` string: The ID of the customer which was created when the mandate import was processed.
      - `customer_bank_account` string: The ID of the customer bank account which was created when the mandate import was processed.
    - `processing_errors` MandateImportEntryProcessingErrors, nullable, required: Per-resource processing errors
  - `meta` MandateImportEntryPaginationMeta: 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)