How to Connect - Inyett API

Prerequisites

Before you begin calling the Inyett API, make sure you have the following:

An Inyett account — Create your Account if you don’t have one yet.
An API Key – Fetch your API Key connected to your Inyett Account.
An HTTP client — Such as curl, Postman, or a library like axios for JavaScript.

Steps

1

Make Your First Request

With your API key in hand, you’re ready to make your first request. The example below retrieves basic company information for a swedish company by calling the endpoint /info in the Inyett Company Data scope.

curl GET
/3/{SE}/company-data/companies/{SE}/{5567804348}/info
  -H "Authorization: Bearer YOUR_API_KEY"

A successful response will look like this:

{
  "orgNumber": "5567804348",
  "name": "Inyett AB",
  "coAddress": "",
  "address": "Redaregatan 50",
  "zipCode": "25236",
  "phonenumber": "042-210007",
  "faxnumber": "",
  "email": "ekonomi@inyett.se",
  "community": "HELSINGBORG",
  "county": "SKÅNE",
  "legalGroup": "AB",
  "legalGroupText": "Privat aktiebolag",
  "registrationDate": "2009-04-06T00:00:00",
  "vatRegistered": true,
  "vatNr": "SE556780434801",
  "vatStartdate": "2009-04-01T00:00:00",
  "statusCode": "100",
  "statusDescription": "Aktivt",
  "statusName": "Aktivt",
  "statusDateFrom": "2009-04-06T00:00:00",
  "town": "Helsingborg",
  "specialInformations": [
    {
      "name": "Arb av reg",
      "code": "AARG",
      "value": "Yes"
    },
    {
      "name": "F-tax",
      "code": "FTAX",
      "value": "Yes"
    },
    {
      "name": "F-tax start date",
      "code": "FTXSD",
      "value": "2009-05-06"
    },
    {
      "name": "F-tax end date",
      "code": "FTXED",
      "value": ""
    },
    {
      "name": "F-tax registration specification",
      "code": "FTXRS",
      "value": "1"
    },
    {
      "name": "F-tax deregistration reason code",
      "code": "FTXDRC"
    },
    {
      "name": "Sni",
      "code": "SNIC",
      "value": "62100"
    },
    {
      "name": "Sni description",
      "code": "SNICD",
      "value": "Dataprogrammering"
    },
    {
      "name": "Number of employees interval",
      "code": "NREMI",
      "value": "20-49 anställda"
    },
    {
      "name": "Company is active by status code",
      "code": "CASC",
      "value": "Yes"
    }
  ]
}

The data array contains the returned records, while the meta object provides pagination information about the full result set.

2

Handle the Response

Every successful response from the Inyett API follows the same structure:

data — An array of resource objects matching your query. Each object contains the fields relevant to that resource type.
meta — An object containing pagination details: total (total number of records), page (the current page), and per_page (the number of records per page).

Use the values in meta to implement pagination in your application — for example, by incrementing the page parameter until you’ve retrieved all records.

Store your API key securely. Never commit it to source control. Use environment variables or a secrets manager like AWS Secrets Manager or HashiCorp Vault to keep your key safe.

Code Examples

The following code group shows how to make the same request in multiple languages:

curl https://api.inyett.com/v1/users \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch("https://api.inyett.com/v1/users", {
  method: "GET",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
});

const { data, meta } = await response.json();
console.log(data);

import requests

url = "https://api.inyett.com/v1/users"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)
payload = response.json()

print(payload["data"])
print(payload["meta"])

⌘I