Biklo for developersTESTsandbox-api.biklo.comchange

One customer and their orders

GET/v1/customers/{id}

scope customers.read

A buyer, their billing details, and every order they have placed with you — each flagged with whether it already carries an invoice, so a nightly job can pick up exactly the ones it has not billed. A buyer who has never ordered from you is customer_not_found (404), which is also what stops you reaching anyone else's customers.

Response#

FieldTypeDescription
idintegerThe buyer id.
namestringThe buyer's account name.
emailstringTheir account email.
phonestring|nullTheir account phone.
orders_countintegerHow many orders they have placed with you.
first_order_atstringISO-8601 UTC of their first order with you.
last_order_atstringISO-8601 UTC of their most recent.
billingobject|nullThe address to invoice at. null when the order carries no address — old orders and a handful of edge cases.
billing.address_linestring|nullStreet and number. null when the buyer has since deleted the address the order pointed at — see is_live. Everything else in this block still stands, because it was snapshotted at checkout.
billing.citystringSnapshotted at checkout. This is the city the parcel was actually sent to.
billing.countystringCounty, judet or equivalent. Snapshotted at checkout.
billing.postal_codestring|nullSnapshotted at checkout, falling back to the address record for the few orders carrying none.
billing.country_codestringISO 3166-1 alpha-2, e.g. RO.
billing.countrystring|nullThe country name in Romanian, for printing. null alongside a null address_line.
billing.is_companybooleanThe buyer ordered as a BUSINESS and must be invoiced as one — in Romania that means the invoice carries the company name and CUI, not the person's. Branch on this rather than on whether company happens to be populated.
billing.companyobject|nullThe company to invoice, or null for a private buyer.
billing.company.namestringRegistered company name.
billing.company.vat_codestring|nullVAT number — the Romanian CUI/CIF, e.g. RO12345678.
billing.company.registration_nostring|nullTrade register number, e.g. J16/123/2020.
billing.is_livebooleanREAD THIS ONE. true means address_line was read from an address the buyer still controls and can edit, so it is their CURRENT street, not necessarily the one at the time of sale. Only the city, county, postcode and country are frozen. If your invoices must be reproducible, store the block when you issue the invoice rather than re-fetching it later. false means the address was deleted and address_line is null.
billing.delivered_to_lockerbooleanThe parcel went to a locker. The address here is still the buyer's own — this is a delivery detail, not a billing one.
ordersarrayEvery order this buyer placed with you, newest first.
orders[].idintegerThe order id. Use it with POST /v1/orders/{id}/invoice.
orders[].referencestring|nullYour own external_order_id, if you set one.
orders[].statusstringSame vocabulary as GET /v1/orders.
orders[].totalobjectWhat the buyer paid.
orders[].total.amountinteger|nullMinor units — 4698 is 46.98.
orders[].total.currencystring|nullISO 4217.
orders[].has_invoicebooleanWhether an invoice has already been attached. This is the field to filter on: false is your queue of orders still to bill.
orders[].created_atstringISO-8601 UTC.

Example

{
    "id": 9000001,
    "name": "John Doe",
    "email": "[email protected]",
    "phone": "+40700000000",
    "orders_count": 2,
    "first_order_at": "2026-03-02T11:40:19Z",
    "last_order_at": "2026-09-08T14:08:52Z",
    "billing": {
        "address_line": "Str. Exemplu 12",
        "city": "Brasov",
        "county": "Brasov",
        "postal_code": "500002",
        "country_code": "RO",
        "country": "România",
        "is_company": true,
        "company": {
            "name": "Example Bike Shop SRL",
            "vat_code": "RO12345678",
            "registration_no": "J16/123/2020"
        },
        "is_live": true,
        "delivered_to_locker": false
    },
    "orders": [
        {
            "id": 690,
            "reference": "ERP-1042",
            "status": "delivered",
            "total": {
                "amount": 4698,
                "currency": "RON"
            },
            "has_invoice": false,
            "created_at": "2026-09-08T14:08:52Z"
        }
    ]
}

Failures use the shared error envelope — a machine-readable code and a request_id to quote to support. Error handling.

curl -X GET "https://sandbox-api.biklo.com/v1/customers/711" \
  -H "Authorization: Bearer bk_test_YOUR_KEY"
<?php

$ch = curl_init('https://sandbox-api.biklo.com/v1/customers/711');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => 'GET',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer bk_test_YOUR_KEY',
    ],
]);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

using System.Net.Http;
using System.Net.Http.Headers;

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", "bk_test_YOUR_KEY");

var request = new HttpRequestMessage(
    new HttpMethod("GET"),
    "https://sandbox-api.biklo.com/v1/customers/711");

var response = await client.SendAsync(request);
var json = await response.Content.ReadAsStringAsync();

import requests

response = requests.get(
    "https://sandbox-api.biklo.com/v1/customers/711",
    headers={"Authorization": "Bearer bk_test_YOUR_KEY"},
)

data = response.json()

const response = await fetch("https://sandbox-api.biklo.com/v1/customers/711", {
  method: "GET",
  headers: {
    Authorization: "Bearer bk_test_YOUR_KEY"
  }
});

const data = await response.json();

import java.net.http.*;
import java.net.URI;

var client = HttpClient.newHttpClient();

var request = HttpRequest.newBuilder()
    .uri(URI.create("https://sandbox-api.biklo.com/v1/customers/711"))
    .header("Authorization", "Bearer bk_test_YOUR_KEY")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

var response = client.send(request, HttpResponse.BodyHandlers.ofString());