Naar de inhoud
NLEN
Open Nexym

List stock levels

GET
/api/connect/stock
curl --request GET \
  --url 'https://app.nexym.nl/api/connect/stock?per_page=50&page=1' \
  --header 'Authorization: Bearer <token>'

A page of stock rows for the key’s project. Each row carries a trimmed variant — only id, reference and sku.

Requires stock: read (or write).

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
per_page
integer
default: 50 >= 1 <= 200

Records per page. Values above 200 are silently clamped to 200. The value is not otherwise validated, so send a sensible positive integer.

page
integer
default: 1 >= 1

1-based page number.

Responses

Section titled “Responses”

200

Section titled “200”

A page of stock rows.

Media typeapplication/json
object
current_page
required
integer
data
required
Array<object>
object
first_page_url
required
string format: uri
from
required

Index of the first record on this page, or null on an empty page.

integer | null
last_page
required
integer
last_page_url
required
string format: uri
links
required
Array<object>

One entry of the paginator’s rendered link list.

object
url
string | null format: uri
label
string
page
integer | null
active
boolean
next_page_url
required
string | null format: uri
path
required
string format: uri
per_page
required
integer
prev_page_url
required
string | null format: uri
to
required
integer | null
total
required
integer
data
required
Array<object>

Quantity of one variant at one location.

object
id
integer
project_id
integer
variant_id
integer
location_reference

The warehouse or shop this quantity is held at. Rows written through this API without a location use the literal default.

string | null
qty
integer | null
qty_available

Free to sell — qty minus whatever the source reports as reserved.

integer | null
qty_reserved
integer | null
meta

Free-form store for fields the universal schema does not define for everybody: a connector’s declared extension fields and a project’s own customer fields, each under its own name.

object | null
synced_at
string | null format: date-time
created_at
string | null format: date-time
updated_at
string | null format: date-time
variant

The variant a stock row belongs to, as the stock listing returns it.

object
id
integer
reference
string
sku
string | null

Example 

{
  "current_page": 1,
  "first_page_url": "https://app.nexym.nl/api/connect/orders?page=1",
  "from": 1,
  "last_page": 7,
  "last_page_url": "https://app.nexym.nl/api/connect/orders?page=7",
  "links": [
    {
      "url": "https://app.nexym.nl/api/connect/orders?page=2",
      "label": "2",
      "page": 2,
      "active": false
    }
  ],
  "next_page_url": "https://app.nexym.nl/api/connect/orders?page=2",
  "path": "https://app.nexym.nl/api/connect/orders",
  "per_page": 50,
  "prev_page_url": null,
  "to": 50,
  "total": 318,
  "data": [
    {
      "id": 55102,
      "project_id": 3,
      "variant_id": 90412,
      "location_reference": "default",
      "qty": 42,
      "qty_available": 42,
      "qty_reserved": 0,
      "meta": {
        "service_code": "INSTALL-STD"
      },
      "synced_at": "2026-09-19T06:30:02.000000Z",
      "created_at": "2026-08-01T11:03:29.000000Z",
      "updated_at": "2026-09-19T06:30:02.000000Z",
      "variant": {
        "id": 90412,
        "reference": "ACME-1234-BLK",
        "sku": "ACME-1234-BLK"
      }
    }
  ]
}

401

Section titled “401”

No key, a key that does not match, a revoked key, or an expired one. The body says which, and nothing else — an unusable key is never described further.

Media typeapplication/json

Every error this API returns carries a single human-readable message.

object
message
required
string

Examples

No bearer token, or one too short to hold a prefix

{
  "message": "Missing or invalid API key."
}

403

Section titled “403”

The key is valid but its abilities do not cover this resource at this right.

Media typeapplication/json

Every error this API returns carries a single human-readable message.

object
message
required
string

Examples

{
  "message": "This API key lacks read access to orders."
}

429

Section titled “429”

The per-minute rate limit was exceeded. The limit is 120 requests per minute by default (CONNECT_API_RATE_PER_MIN), counted per API key — or per IP address for a request that never authenticated.

Media typeapplication/json

Every error this API returns carries a single human-readable message.

object
message
required
string

Examples

Examplelimited
{
  "message": "Too many requests — slow down."
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds until the limit resets.

X-RateLimit-Limit
integer

Requests allowed per minute.

X-RateLimit-Remaining
integer

Requests left in the current window.