---
title: "GET /user/{userID}/monetary-account/{monetary-accountID}/payment-auto-allocate/{payment-auto-allocateID}/definition"
method: GET
path: "/user/{userID}/monetary-account/{monetary-accountID}/payment-auto-allocate/{payment-auto-allocateID}/definition"
tags: ["definition"]
---

# GET /user/{userID}/monetary-account/{monetary-accountID}/payment-auto-allocate/{payment-auto-allocateID}/definition

`GET /user/{userID}/monetary-account/{monetary-accountID}/payment-auto-allocate/{payment-auto-allocateID}/definition`

## Request

- Base URL: `https://public-api.sandbox.bunq.com/v1`
- URL: `https://public-api.sandbox.bunq.com/v1/user/{userID}/monetary-account/{monetary-accountID}/payment-auto-allocate/{payment-auto-allocateID}/definition`
- Auth: none declared. Required headers: `User-Agent`, `X-Bunq-Client-Authentication`

List all the definitions in a payment auto allocate.

## Path parameters

- `userID` integer, required
- `monetary-accountID` integer, required
- `payment-auto-allocateID` 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 all the definitions in a payment auto allocate.

- PaymentAutoAllocateDefinitionListing[]
  - `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.
  - `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.

## Other responses

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

---

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