---
title: "List BACS direct credit transactions [beta]"
method: GET
path: "/v1/payments/bacs/directcredit"
tags: ["BACS direct credit"]
---

# List BACS direct credit transactions \[beta\]

`GET /v1/payments/bacs/directcredit`

## Request

- Base URL: `https://sandbox.pismolabs.io/bacs`
- URL: `https://sandbox.pismolabs.io/bacs/v1/payments/bacs/directcredit`
- Auth: none declared. Required headers: `Authorization`

List BACS direct credit transactions for an account.

This endpoint takes an account token - an access token encoded with a Pismo account ID.  The account is parsed from the token.

## Query parameters

- `id` string
- `status` 'CREATED' | 'PROCESSING' | 'SETTLED' | 'CANCELLED' | 'HOLD'
- `transactionType` 'DIRECTDEBIT_INBOUND' | 'DIRECTDEBIT_OUTBOUND' | 'DIRECTDEBIT_IN_RETURN' | 'DIRECTDEBIT_OUT_RETURN' | 'DIRECTDEBIT_IN_REVERSAL' | 'DIRECTDEBIT_OUT_REVERSAL'
- `beginDate` string
- `endDate` string
- `afterId` string
- `pageSize` integer

## Headers

- `Authorization` string, required
- `x-cid` string

## Response `200`

Paginated list of direct credit transactions

- ListingTransactionListResponse: Paginated list of BACS transactions.
  - `items` ListingTransaction[]
    - `id` string: Transaction ID
    - `org_id` string: Organization/tenant ID
    - `account_id` integer: Account ID
    - `transaction_type` 'DIRECTCREDIT_INBOUND' | 'DIRECTCREDIT_OUTBOUND' | 'DIRECTCREDIT_REVERSAL' | 'DIRECTCREDIT_OUTBOUND_REVERSAL' | 'DIRECTCREDIT_IN_RETURN' | 'DIRECTCREDIT_OUT_RETURN' | 'DIRECTDEBIT_OUTBOUND' | 'DIRECTDEBIT_OUT_RETURN': Transaction type
    - `reference` string: Reference note
    - `mandate_id` string: Form3-assigned mandate ID
    - `payment_scheme` 'BACS': Payment scheme
    - `transaction_status` 'CREATED' | 'PROCESSING' | 'SETTLED' | 'CANCELLED' | 'HOLD': - `CREATED` - Payment has been created and is pending processing<br /> - `PROCESSING` - P2P balance was impacted and waiting for provider confirmation. For cashin, the transaction means the money will be credited on the next Working Day<br /> - `SETTLED` - Transaction completed processing and is settled<br /> - `CANCELLED` - Something went wrong and the transaction is cancelled. Refer to `reason` for more details<br /> - `HOLD` - The payment is on hold, pending further review<br />
    - `amount` number: Transaction amount.
    - `currency_code` integer: ISO 4217 numeric currency code
    - `processing_date` string: Processing date. Format = yyyy-mm-dd
    - `return_reason` 'account_closed' | 'account_currency_mismatch' | 'cancelled_by_payer' | 'other': The reason for the return. * `account_closed` — The beneficiary account is no longer active. * `account_currency_mismatch` — The payment currency does not match the account currency. * `other` — A reason that the other specific codes do not cover. * `cancelled_by_payer`— The payer requests cancellation of the payment.
    - `return_code` '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | 'A' | 'B': ARUDD (Automated Return of Unpaid Direct Debit) return code: * `0` - Refer to payer * `1` - Instruction cancelled * `2` - Payer deceased * `3` - Account transferred * `4` - Advance notice disputed * `5` - No account * `6` - No instruction * `7` - Amount differs * `8` - Amount not due * `9` - Presentation overdue * `A` - Originator differs * `B` - Account closed
    - `return_origin` 'CLIENT' | 'SYSTEM': Indicates whether the client or the system initiates the return * `CLIENT`—The client initiates the return via this endpoint * `SYSTEM`—The system initiates the return automatically
    - `original_transaction_id` string: Original transaction ID
    - `created_at` string, date-time: Created at date-time. RFC 3339 format
    - `updated_at` string, date-time: Updated at date-time. RFC 3339 format
  - `next_page` boolean: Are there more results?
  - `after_id` string: Pagination cursor to pass as query parameter to get the next page

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/pismo/apis/payment-rails-bacs-payments.md) - [All operations](https://skmtc.dev/pismo/apis/payment-rails-bacs-payments/llms.txt) - [OpenAPI document](https://skmtc.dev/pismo/apis/payment-rails-bacs-payments/revisions/d0f145ee1aba?raw)