Ir al contenido

GET /orders/

Método: GET
URL: https://pos.b4bit.com/api/v1/orders/
Autenticación: header X-Device-Id.

Query params

Param	Formato	Default	Descripción
`start`	`YYYY/MM/DD`	hoy − 7 días	Fecha inicial (inclusiva, UTC).
`end`	`YYYY/MM/DD`	hoy	Fecha final (inclusiva, UTC).

Ver paginación. No hay paginación numérica; controle el volumen acotando el rango.

Ejemplos

# últimos 7 días
curl -H "X-Device-Id: $B4BIT_API_KEY" \
https://pos.b4bit.com/api/v1/orders/

# rango específico
curl -H "X-Device-Id: $B4BIT_API_KEY" \
"https://pos.b4bit.com/api/v1/orders/?start=2026/01/01&end=2026/01/31"

const url = new URL('https://pos.b4bit.com/api/v1/orders/');
url.searchParams.set('start', '2026/01/01');
url.searchParams.set('end', '2026/01/31');

const res = await fetch(url, {
headers: { 'X-Device-Id': process.env.B4BIT_API_KEY },
});
const payments = await res.json(); // array plano

import os, requests

r = requests.get(
  'https://pos.b4bit.com/api/v1/orders/',
  headers={'X-Device-Id': os.environ['B4BIT_API_KEY']},
  params={'start': '2026/01/01', 'end': '2026/01/31'},
)
payments = r.json()  # list

Respuesta `200`

Array de objetos Payment ordenados por created_at descendente:

[
  {
    "identifier": "1040095a-737d-41a2-a2e1-d031d19ec8cd",
    "reference": null,
    "created_at": "2026-04-16T04:02:04.052542+02:00",
    "edited_at": "2026-04-16T04:02:04.052578+02:00",
    "status": "NR",
    "fiat_amount": 1.43,
    "fiat": "MXN",
    "crypto_amount": null,
    "unconfirmed_amount": 0.0,
    "confirmed_amount": 0.0,
    "currency_id": null,
    "merchant_device_id": 10,
    "merchant_device": "b4bit test pro 5.0",
    "address": null,
    "tag_memo": "",
    "url_ko": null,
    "url_ok": null,
    "url_standby": null,
    "expired_time": null,
    "good_fee": false,
    "notes": null,
    "rbf": false,
    "safe": false,
    "language": "es",
    "percentage": 0.0,
    "received_amount": 0.0,
    "internal_data": null,
    "transactions": []
  }
]

Ver payment-fields para el glosario completo de campos.

Errores

403 — Falta o inválida la X-Device-Id.
429 — Rate limit. Ver rate-limits.
500 — Error interno.