---
title: "List payment admissions"
method: GET
path: "/v0/payments/{payment-id}/admissions"
tags: ["Payments"]
---

# List payment admissions

`GET /v0/payments/{payment-id}/admissions`

## Request

- Base URL: `https://api.griffin.com`
- URL: `https://api.griffin.com/v0/payments/{payment-id}/admissions`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/griffin/apis/the-griffin-api/docs/v0/payments/:payment-id/admissions/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists admissions for a payment. A payment may have at most one admission.

## Path parameters

- `payment-id` string, required

## Response `200`

OK

- object
  - `admissions` object[], required
    - `admission-status` 'cancelled' | 'processing' | 'returned' | 'delivered', required: Specifies the progress of the inbound payment.
    - `admission-scheme-information` union, required
      - object
        - `end-to-end-identification` string, required: An identifier for a payment, assigned by the originator, passed along unchanged throughout the entire end-to-end chain. Not necessarily unique.
        - `payment-scheme` 'fps', required
      - object
        - `end-to-end-identification` string, required: An identifier for a payment, assigned by the originator, passed along unchanged throughout the entire end-to-end chain. Not necessarily unique.
        - `payment-scheme` 'book-transfer', required
      - object
        - `payment-scheme` 'chaps', required
      - object
        - `payment-scheme` 'bacs', required
    - `payment-url` string, required: Link to the payment resource.
    - `created-at` string, date-time, required: ISO 8601 formatted date-time.
    - `admission-url` string, required
    - `unique-scheme-identifier` string, required
    - `account-url` union, required: Link to the bank account resource.
      - string
      - string
    - `original-unique-scheme-identifier` string

## Other responses

- `401`: Requires an API key to continue
- `404`: Not Found

## Changes

- **2026-09-19** `3e69d9e24ef6`: 1 info
  - api operation id `get-payments-payment-id-admissions` was added

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/payments/:payment-id/admissions/get.md)

---

[API](https://skmtc.dev/griffin/apis/the-griffin-api.md) - [All operations](https://skmtc.dev/griffin/apis/the-griffin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/griffin/apis/the-griffin-api/revisions/9e4c303c70a5?raw)