aventra.Developers
API referenceCompanies

List companies

Read a bounded page of companies from your workspace, ordered by CRM ID. Deleted companies are excluded; archived companies are included.

Permissions: Companies: read.

Behavior and retry rules

Use limit (1–100, default 25) and offset (0–10000, default 0). Advance offset by limit while page.has_more is true. page.size is the requested limit, not the returned row count. Pagination is not a snapshot: concurrent inserts or deletes can shift pages. This endpoint is intended for bounded lookups, not a full database export.

GET/companies

Authorization

bearerAuth
AuthorizationBearer <token>

Create a key in Aventra → Innstillinger → API-nøkler.

In: header

Query Parameters

limit?integer
Range1 <= value <= 100
Default25
offset?integer
Range0 <= value <= 10000
Default0

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/companies" \  -H "Authorization: Bearer $AVENTRA_API_KEY"
{  "data": [    {      "id": "4d73dca4-7537-4f9c-924e-8bccd354663f",      "orgnr": "923609016",      "name": "Eksempel AS",      "status": "prospect",      "assigned_to": null,      "source": "api",      "org_form": "AS",      "registered_at": "2019-10-16",      "employees": 8,      "nace_primary": "62.010",      "email_address": null,      "phone_number": null,      "mobile_number": null,      "website_url": null,      "is_archived": false,      "is_deleted": false    }  ],  "page": {    "size": 25,    "offset": 0,    "has_more": false  }}

See authentication, errors and retry guidance.