Skip to content

GET /orders/

Method: GET
URL: https://pos.b4bit.com/api/v1/orders/
Authentication: X-Device-Id header.

Query params

Param	Format	Default	Description
`start`	`YYYY/MM/DD`	today − 7 days	Start date (inclusive, UTC).
`end`	`YYYY/MM/DD`	today	End date (inclusive, UTC).

See pagination. There is no numeric pagination; control volume by narrowing the range.

Examples

# ú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

`200` response

Array of Payment objects sorted by created_at descending:

[
  {
    "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": []
  }
]

See payment-fields for the full field glossary.

Errors

403 — Missing or invalid X-Device-Id.
429 — Rate limit. See rate-limits.
500 — Internal error.