---
title: "List direct debit batch approval tasks"
method: GET
path: "/payments/v2beta/direct-debit-batches/{id}/approval-tasks"
tags: ["Direct Debits"]
---

# List direct debit batch approval tasks

`GET /payments/v2beta/direct-debit-batches/{id}/approval-tasks`

## Request

- Base URL: `https://api.atlar.com`
- URL: `https://api.atlar.com/payments/v2beta/direct-debit-batches/{id}/approval-tasks`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/atlar/apis/atlar-api-v2/docs/payments/v2beta/direct-debit-batches/:id/approval-tasks/get.ts> (a function with typed inputs; its response is checked against the schema)

List all approval tasks for the given batch.

## Path parameters

- `id` string, required

## Query parameters

- `token` string
- `limit` integer

## Response `200`

A list of approval tasks.

- object
  - `items` PaymentApprovalTask[], required: A list of resources.
    - `id` string, required: Unique resource identifier.
    - `organizationId` string, required: Unique resource identifier.
    - `status` 'CREATED' | 'PROCESSING_STARTED' | 'COMPLETED' | 'CANCELLING' | 'CANCELLED', required: Lifecycle status of an asynchronous task.
    - `timeout` integer, required: The maximum runtime in seconds.
    - `runtimeMs` integer, required: Elapsed runtime in milliseconds.
    - `processed` integer, required: Number of items processed so far.
    - `starterUserId` string, required: Unique resource identifier.
    - `starterRoleId` string, required: Unique resource identifier.
    - `errors` ErrorDetails[]
      - `code` string: An error code for this error. Not always present.
      - `error` string: A description of this specific error.
      - `field` string: The field which has an error. This only set if the error has to do with a specific field, such as for validation errors. Nested fields are concatenated with `.`, as well as indexed fields in lists.
      - `metadata` object: Optional machine-readable data about the error. What it contains typically depends on `code`. At most 16 entries and 1 KiB in total (keys and values), keys up to 64 chars and values up to 256.
    - `created` string, date-time, required: Time at which the resource was created.
    - `updated` string, date-time, required: Time at which the resource was last updated.
    - `version` integer, required: Resource version. Starts at value `1` when the resource is created and increases by one for each successive update.
    - `input` PaymentApprovalTaskInput, required: Input captured when a payment approval task was created.
      - `batchId` string, required: Unique resource identifier.
      - `action` 'APPROVE' | 'REJECT', required: The action to perform on the approval step.
      - `approver` ApprovalTaskApprover, required: Snapshot of the approver captured when an approval task is created.
        - `userId` string, required: Unique resource identifier.
        - `roleId` string, required
        - `username` string, required
        - `name` string
      - `reason` string: Rejection reason propagated to each payment's reject event. Present when `action` is `REJECT`.
      - `allowDateChange` boolean: Whether payments may have their date adjusted to the next business day during approval processing.
  - `nextToken` string, required: Pagination token for next page. The value will be a non-empty string if there are more resources to be fetched. The value will be an empty string if there are no more resources to be fetched.
  - `token` string, required: The pagination token that was used for this request. The value will be an empty string if no `token` query parameter was provided with the request.
  - `limit` integer, required: The page limit that was used for this request.

## Other responses

- `400`: Bad request.
- `404`: Resource not found.

## Changes

- **2026-11-03** `b49df1e4b3e9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/atlar/apis/atlar-api-v2/changes/payments/v2beta/direct-debit-batches/:id/approval-tasks/get.md)

---

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