---
title: "GET /payments/{payment_ref}"
method: GET
path: "/payments/{payment_ref}"
tags: ["Payments"]
---

# GET /payments/{payment_ref}

`GET /payments/{payment_ref}`

Gets a payment by ID or external ID.

## Path parameters

- `payment_ref` string, required — Payment ID or external ID.

## Response `200`

Success

- PaymentSuccessResponse
  - `data` Payment, required — Payment object.
    - `id` string, required — FRAGMENT generated unique ID.
    - `external_id` string — User-provided unique ID when the payment was created with one.
    - `direction` string, required — Direction of the payment.
    - `amount` string, required — Amount in smallest currency unit.
    - `currency` string, required — Currency code.
    - `status` string, required — Status of the payment.
    - `payment_flow_id` string, required — Payment flow ID.
    - `payment_account_id` string, required — Payment account ID.
    - `transaction_ids` string[], required — Associated transaction IDs.
    - `created` string, required — Timestamp when the payment was created.
    - `modified` string, required — Timestamp when the payment was last modified.

## Other responses

- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

## Changes

- **2026-04-23** `2313a4acc241` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/changes/payments/:payment_ref/get.md)

---

[API](https://skmtc.dev/fragment-dev/apis/fragment-payments-api.md) · [All operations](https://skmtc.dev/fragment-dev/apis/fragment-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fragment-dev/fragment-payments-api/revisions/41ca2c686012/schema)