---
title: "GET /user/{userID}/payment-auto-allocate"
method: GET
path: "/user/{userID}/payment-auto-allocate"
tags: ["payment-auto-allocate"]
---

# GET /user/{userID}/payment-auto-allocate

`GET /user/{userID}/payment-auto-allocate`

List a users automatic payment auto allocated settings.

## Path parameters

- `userID` integer, required

## Headers

- `Cache-Control` string
- `User-Agent` string, required
- `X-Bunq-Language` string
- `X-Bunq-Region` string
- `X-Bunq-Client-Request-Id` string
- `X-Bunq-Geolocation` string
- `X-Bunq-Client-Authentication` string, required

## Response `200`

List a users automatic payment auto allocated settings.

- PaymentAutoAllocateUserListing[]
  - `PaymentAutoAllocate` PaymentAutoAllocate
    - `payment_id` integer, required — The payment that should be used to define the triggers for the payment auto allocate.
    - `type` string, required — Whether a payment should be sorted ONCE or RECURRING.
    - `definition` PaymentAutoAllocateDefinition[], required — The definition of how the money should be allocated.
      - `type` string, required — The type of definition.
      - `counterparty_alias` Pointer
        - `type` string — The alias type, can be: EMAIL|PHONE_NUMBER|IBAN.
        - `value` string — The alias value.
        - `name` string — The alias name.
        - `service` string — The pointer service. Only required for external counterparties.
      - `description` string — The description for the payment.
      - `amount` Amount
        - `value` string — The amount formatted to two decimal places.
        - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
      - `fraction` integer — The percentage of the triggering payment's amount to allocate.
      - `id` integer — The id of the PaymentAutoAllocateDefinition.
      - `created` string — The timestamp when the PaymentAutoAllocateDefinition was created.
      - `updated` string — The timestamp when the PaymentAutoAllocateDefinition was last updated.

## Other responses

- `400` — This is how the error response looks like for 4XX response codes

---

[API](https://skmtc.net/bunq/apis/bunq-api.md) · [All operations](https://skmtc.net/bunq/apis/bunq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bunq/bunq-api/revisions/369477c7bd26/schema)