Skip to main content
GET
/
prices
/
{id}
curl https://api.onepay.la/v1/prices/9f5d85a0-2222-7000-aaaa-000000000002 \
  -H "Authorization: Bearer sk_test_xxx"

const response = await fetch('https://api.onepay.la/v1/prices/9f5d85a0-2222-7000-aaaa-000000000002', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_test_xxx'
  }
});

const data = await response.json();

import requests

response = requests.get(
    'https://api.onepay.la/v1/prices/9f5d85a0-2222-7000-aaaa-000000000002',
    headers={
        'Authorization': 'Bearer sk_test_xxx'
    }
)

data = response.json()

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.onepay.la/v1/prices/9f5d85a0-2222-7000-aaaa-000000000002",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer sk_test_xxx"
    ]
]);

$data = json_decode(curl_exec($curl), true);
?>

{
  "id": "9f5d85a0-2222-7000-aaaa-000000000002",
  "object": "price",
  "product": "9f5d85a0-1111-7000-aaaa-000000000001",
  "active": true,
  "nickname": "Mensual",
  "lookup_key": "pro_monthly",
  "currency": "COP",
  "unit_amount_in_cents": 7990000,
  "type": "recurring",
  "recurring": {
    "interval": "month",
    "interval_count": 1,
    "total_cycles": null,
    "trial_period_days": 0
  },
  "created_at": "2026-07-13T12:00:00.000000Z"
}

{
  "message": "No encontrado",
  "code": 10004,
  "code_name": "not_found"
}
Obtiene los detalles de un precio específico. Devuelve 404 si el precio no pertenece a tu empresa o si no es un precio de catálogo (sin producto asociado).

​
Path Parameters

​
id
string
required
ID del precio a consultar. Crear precio.
curl https://api.onepay.la/v1/prices/9f5d85a0-2222-7000-aaaa-000000000002 \
  -H "Authorization: Bearer sk_test_xxx"

const response = await fetch('https://api.onepay.la/v1/prices/9f5d85a0-2222-7000-aaaa-000000000002', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer sk_test_xxx'
  }
});

const data = await response.json();

import requests

response = requests.get(
    'https://api.onepay.la/v1/prices/9f5d85a0-2222-7000-aaaa-000000000002',
    headers={
        'Authorization': 'Bearer sk_test_xxx'
    }
)

data = response.json()

<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.onepay.la/v1/prices/9f5d85a0-2222-7000-aaaa-000000000002",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer sk_test_xxx"
    ]
]);

$data = json_decode(curl_exec($curl), true);
?>

​
Response

​
id
string
Identificador único del precio (UUID).
​
object
string
Tipo de objeto, siempre price.
​
product
string
ID del producto padre al que pertenece el precio.
​
active
boolean
Indica si el precio está vigente. Un precio archivado es false.
​
nickname
string
Etiqueta interna del precio. Puede ser null.
​
lookup_key
string
Clave estable para re-apuntar el precio vigente sin cambiar tu código. Puede ser null.
​
currency
string
Moneda ISO del cobro (por ejemplo COP).
​
unit_amount_in_cents
integer
Monto a cobrar, expresado en centavos.
​
type
string
Tipo de precio, siempre recurring.
​
recurring
object
Configuración de recurrencia del cobro.
​
created_at
string
Fecha de creación en formato ISO 8601.
{
  "id": "9f5d85a0-2222-7000-aaaa-000000000002",
  "object": "price",
  "product": "9f5d85a0-1111-7000-aaaa-000000000001",
  "active": true,
  "nickname": "Mensual",
  "lookup_key": "pro_monthly",
  "currency": "COP",
  "unit_amount_in_cents": 7990000,
  "type": "recurring",
  "recurring": {
    "interval": "month",
    "interval_count": 1,
    "total_cycles": null,
    "trial_period_days": 0
  },
  "created_at": "2026-07-13T12:00:00.000000Z"
}

{
  "message": "No encontrado",
  "code": 10004,
  "code_name": "not_found"
}