# Obtener un beneficio (https://docs.loybox.com.ar/api-reference/beneficios/obtener)



<Endpoint method="GET" path="/v1/benefits/{benefit_id}" auth="api-key" />

Trae información sobre un beneficio del catálogo usando su id.

<Callout type="info" title="Este endpoint no canjea nada">
  El `benefit_id` identifica un beneficio del **catálogo**, no el de un cliente
  concreto. Para consultar el beneficio que un cliente trae para usar, el
  identificador es el `client_benefit_code` y el endpoint es
  [consultar un código](https://docs.loybox.com.ar/api-reference/beneficios/consultar-codigo).
</Callout>

## Parámetros [#parámetros]

<Fields>
  <Field name="benefit_id" type="string" location="path" required="true">
    El id del beneficio.
  </Field>
</Fields>

## Respuesta [#respuesta]

Un objeto [Beneficio](https://docs.loybox.com.ar/api-reference/objetos#beneficio).

```bash
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/benefits/b_9f2a \
  -H "Authorization: Bearer $LOYBOX_API_KEY"
```

```json
// 200 OK
{
  "id": "b_9f2a",
  "type": "percentage_discount",
  "description": "20% de descuento en toda la tienda",
  "cost": 250,
  "expiration": "2026-12-31T23:59:59Z",
  "benefit_type": "normal",
  "color": "#f1a10d",
  "buy_limit": 0,
  "prize": {
    "type": "percentage_discount",
    "title": "20% off",
    "description": "Válido en toda la tienda",
    "value": 20,
    "product": null,
    "expiration": "2026-12-31T23:59:59Z",
    "image": null
  },
  "tiendanube_coupon": null
}
```

## Errores [#errores]

| Código | Cuándo                                                 |
| ------ | ------------------------------------------------------ |
| `401`  | La API key es inválida: no tiene un comercio asociado. |
| `404`  | El beneficio no existe.                                |
| `422`  | El id no tiene un formato válido.                      |