Create or find a company
Add a Norwegian company by organisation number. Aventra supplies the register details. An existing company is returned without changing it.
Permissions: Companies: read and write.
Behavior and retry rules
A new company returns 201 with created: true. An existing company returns 200 with created: false; submitted fields are ignored for that existing company. Use PATCH to update it. Repeated or concurrent requests for the same organisation number converge on the same company in your workspace. Deleted companies return 409; restore them in Aventra. A company missing from Aventra's register returns 422. New companies include basic register and contact details; this operation does not perform a credit assessment or import financial statements.
/companiesAuthorization
bearerAuth Create a key in Aventra → Innstillinger → API-nøkler.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/companies" \ -H "Authorization: Bearer $AVENTRA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "orgnr": "923609016", "status": "prospect" }'{ "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 }, "created": false}See authentication, errors and retry guidance.