Custom objects

List records

Records of one object, sorted by name. fields maps field key → value (date YYYY-MM-DD, number, option text, array for multi-select, user id for person fields); sub is the short summary shown on cards; customer is the linked company (if any).

GET/api/v1/objects/{key}/records

Authorization

Authorizationheaderrequired

Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).

Module: CustomersScope: crm.read

Path parameters

keystringrequired

Object key (/objects → key).

Query parameters

qstringoptional

Name contains.

customer_idintegeroptional

Records linked to this company.

archivedstringoptional

1 = include archived.

pageintegeroptionaldefault: 1

Page (from 1).

perintegeroptionaldefault: 50

Per page (10–200).

Errors

HTTP	error	Meaning
`404`	`not_found`	Record not found.

Request

curl "https://ornek.solk.app/api/v1/objects/uretim_hatti/records?customer_id=1" \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/objects/uretim_hatti/records?customer_id=1", {
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://ornek.solk.app/api/v1/objects/uretim_hatti/records",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    params={"customer_id": 1},
)
print(r.json())

Response

{
  "object": "uretim_hatti",
  "ok": true,
  "page": 1,
  "pages": 1,
  "rows": [
    {
      "active": true,
      "customer": {
        "id": 1,
        "name": "Alize Paketleme San. ve Tic. A.Ş."
      },
      "fields": {
        "devreye_alma": "2025-04-01",
        "hiz": 180.0,
        "makine_tipi": "Ekstrüzyon"
      },
      "id": 1,
      "name": "Hat 3 — şişirme",
      "owner": "Deniz Aksoy",
      "owner_id": 1,
      "sub": "Ekstrüzyon · 180",
      "updated_at": "2026-10-06T10:26:24"
    }
  ],
  "total": 1
}

Example responses were captured from a v43b installation running sample data; lists are shortened to two items.