# API · Get a payment link by id

> Query of a single payment link by its id.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-08-29
- url: https://tilopay.com/en/developers/api/links-de-pago/payment-by-id

```http
GET /api/v1/getLinkPaymentById/{link_payment_id}/{api_key}
```

## What it does [#que-hace]

Returns a single payment link. It takes no body: the data travels in the path.

## Authentication [#autenticacion]

Requires the API bearer token in the `Authorization` header — see [authentication](/en/developers/api/autenticacion).

## Parameters [#parametros]

Path parameters, in the order they appear in the URL:

<Param id="payment-by-id-parametro-link-payment-id" name="link_payment_id" type="string · path" required>
Id of the payment link to query.
</Param>

<Param id="payment-by-id-parametro-api-key" name="api_key" type="string · path" required>
Merchant api key.
</Param>

## Response [#respuesta]

```json
{
  "type": "200",
  "message": "Success",
  "data": {
    "id": 1,
    "amount": "45.00",
    "currency": "USD",
    "reference": "Producto de prueba 1 TP-Shop",
    "url": "https://admin.tilopay.com/link/loNj8E2MA==",
    "callback_url": null,
    "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
    "times_used": null,
    "picture": "https://storage.googleapis.com/tilo-uploads/items/51087219_.png",
    "create": "2022-10-24 08:45:14",
    "payments": []
  }
}
```

To interpret a response that is not a success, see [how to read an error response](/en/developers/api/procesos-operativos/errors).