---
title: "Get Payment Link"
method: GET
path: "/payment-links/v1/{payment_link_id}"
tags: ["Payment Links"]
---

# Get Payment Link

`GET /payment-links/v1/{payment_link_id}`

Retrieves the current state of a payment link, including its status, usage count, and configuration.

## Path parameters

- `payment_link_id` string, uuid, required

## Response `200`

OK

- PaymentLinkResponse — The full state of a payment link, including its shareable URL, current status, usage counts, and configuration.
  - `id` string, uuid, required — The unique ID of this payment link. Use this to retrieve, update, or reference the link in other API calls.
  - `link` string, uri, required — The URL to share with your customer. Directing a customer to this URL begins the payment flow. Anyone with this URL can initiate a payment.
  - `status` 'ACTIVE' | 'EXPIRED' | 'USED' | 'DISABLED', required — The lifecycle state of a payment link. - ACTIVE: The link is live and will accept payments. This is the initial state after creation. - EXPIRED: The link's `expires_at` time has passed. It can no longer accept payments and cannot be reactivated. - USED: The link has reached its `max_usages` limit. All permitted payments have been collected. Cannot be reactivated. - DISABLED: The link was manually disabled via the update endpoint. It can be re-enabled by setting status to `ACTIVE`.
  - `current_usages` integer, required — The number of successful payments completed through this link. Increments each time a payer completes a payment. Compare with `max_usages` to understand remaining capacity.
  - `name` string, nullable — The label you provided when creating the link, if any. For display purposes only.
  - `max_usages` integer, nullable — The maximum number of payments this link will accept before transitioning to USED status. Null indicates no limit.
  - `expires_at` string, date-time, nullable — The expiry date and time for this link in ISO 8601 format. After this time the link cannot be used. Null means the link does not expire automatically.
  - `redirect_url` string, uri, required — The URL your customer is redirected to after completing or cancelling a payment.
  - `customer_id` string, uuid, nullable — The ID of the customer associated with this link, if any. Payments through this link will be attributed to this customer.
  - `payment_details` PaymentDetailsResponse, required — The payment parameters attached to this link. These values are fixed for the lifetime of the link.
    - `destination_id` string, uuid, nullable — Identifier of the destination account for the payment
    - `reference` string, required — A reference string that appears on the bank statement for both sender and recipient.
    - `currency` string, required — The ISO 3 letter currency code
    - `amount` number, double, required — The amount charged through this link, in the specified currency.
    - `payment_purpose` 'FIS' | 'TCS' | 'MWP' | 'OAT' | 'IFS' | 'RNT' | 'LNC' | 'PIN' | 'GDS' — A category code that relates to the type of services or goods that corresponds to the underlying purpose of the payment. The code must conform to the payment purpose code list. **Supported values:** - `FIS` – Financial services - `TCS` – Telecommunication services - `MWP` – Mobile wallet card payments - `OAT` – Own account transfer - `IFS` – Information services - `RNT` – Rent payments - `LNC` – Loan charges - `PIN` – Personal investments - `GDS` – Goods bought or sold
  - `identifiers` IdentifierResponse[], nullable — The list of additional fields configured to be collected from each payer. Null or empty means no extra information is collected.
    - `type` 'EMAIL' | 'MOBILE_PHONE' | 'TEXT', required — The type of information to collect from the payer. Controls input validation and formatting in the payment UI. - EMAIL: Collects an email address. Input is validated against standard email format. - MOBILE_PHONE: Collects a mobile phone number. Input is validated as a valid phone number. - TEXT: Collects a free-form text value. Use the limit field to constrain length.
    - `display_label` string, nullable — The label shown to the payer for this field, if a custom one was set.
    - `required` boolean, nullable — Whether the payer must fill in this field before completing the payment.
    - `limit` integer, nullable — The maximum number of characters allowed for this field's value.

---

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