---
title: "Get payment initiation authorisation sub-resources request"
method: GET
path: "/v1/{payment-service}/{payment-product}/{paymentId}/authorisations"
tags: ["Payment Initiation Service (PIS)", "Common Services"]
---

# Get payment initiation authorisation sub-resources request

`GET /v1/{payment-service}/{payment-product}/{paymentId}/authorisations`

## Request

- Base URL: `https://api.dev.openbankingproject.ch`
- URL: `https://api.dev.openbankingproject.ch/v1/{payment-service}/{payment-product}/{paymentId}/authorisations`
- Auth: one of:
  - none
  - HTTP bearer

Read a list of all authorisation subresources IDs which have been created.

This function returns an array of hyperlinks to all generated authorisation sub-resources.

## Path parameters

- `payment-service` 'payments' | 'bulk-payments' | 'periodic-payments', required
- `payment-product` 'domestic-swiss-credit-transfers-isr' | 'domestic-swiss-credit-transfers' | 'domestic-swiss-credit-transfers-qr' | 'domestic-swiss-foreign-credit-transfers' | 'swiss-sepa-credit-transfers' | 'swiss-cross-border-credit-transfers' | 'pain.001-sepa-credit-transfers' | 'pain.001-cross-border-credit-transfers' | 'pain.001-swiss-six-credit-transfers', required
- `paymentId` string, required: Resource identification of the generated payment initiation resource.

## Headers

- `X-Request-ID` string, required
- `Digest` string
- `Signature` string
- `TPP-Signature-Certificate` string, byte
- `PSU-IP-Address` string, ipv4
- `PSU-IP-Port` string
- `PSU-Accept` string
- `PSU-Accept-Charset` string
- `PSU-Accept-Encoding` string
- `PSU-Accept-Language` string
- `PSU-User-Agent` string
- `PSU-Http-Method` 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
- `PSU-Device-ID` string
- `PSU-Geo-Location` string

## Response `200`

OK

- Authorisations: An array of all authorisationIds.
  - `authorisationIds` AuthorisationId[], required: An array of all authorisationIds.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `405`: Method Not Allowed
- `406`: Not Acceptable
- `408`: Request Timeout
- `409`: Conflict
- `415`: Unsupported Media Type
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

> 70 revisions in range; 2 not diffed.

- **2021-03-09** `0d82c4699548`: 3 warning, 12 info
  - added the new `SCA_INVALID` enum value to the `additionalErrors/items/code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `code` response property for the response status `400` (media type: application/problem+json)
  - added the new `SCA_INVALID` enum value to the `tppMessages/items/code` response property for the response status `400` (media type: application/json)
  - added the optional property `_links/confirmation` to the response with the `400` status (media type: application/json)
  - …11 more
- **2021-03-09** `b51fe6ddb1fc`: 24 breaking, 12 warning, 12 info
  - removed the enum value `cross-border-credit-transfers` from the `path` request parameter `payment-product`
  - removed the enum value `instant-sepa-credit-transfers` from the `path` request parameter `payment-product`
  - removed the enum value `pain.001-instant-sepa-credit-transfers` from the `path` request parameter `payment-product`
  - removed the enum value `pain.001-target-2-payments` from the `path` request parameter `payment-product`
  - …44 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/changes/v1/:payment-service/:payment-product/:paymentId/authorisations/get.md)

---

[API](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework.md) - [All operations](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/llms.txt) - [OpenAPI document](https://skmtc.dev/openbankingproject-ch/apis/swiss-nextgen-banking-api-framework/revisions/c32e86db40b4?raw)