GET
/
v1
/
lists
/
{id}
/
companies
curl --request GET \
  --url https://api.bizzy.org/v1/lists/{id}/companies \
  --header 'Authorization: Bearer <token>'
{
    "data": [
        {
            "identifier": {
                "country": "BE",
                "companyNumber": "441571714",
                "name": "TOYOTA MOTOR EUROPE",
                "place": "Evere"
            },
            "matchedSince": "2024-11-20T13:47:43.000Z"
        },
        {
            "identifier": {
                "country": "BE",
                "companyNumber": "403834160",
                "name": "Janssen Pharmaceutica",
                "place": "Beerse"
            },
            "matchedSince": "2024-11-20T13:47:43.000Z"
        },
        {
            "identifier": {
                "country": "BE",
                "companyNumber": "403170701",
                "name": "ELECTRABEL",
                "place": "Bruxelles"
            },
            "matchedSince": "2024-11-20T13:47:43.000Z"
        },
        {
            "identifier": {
                "country": "BE",
                "companyNumber": "416375270",
                "name": "EXXONMOBIL PETROLEUM & CHEMICAL",
                "place": "Antwerpen"
            },
            "matchedSince": "2024-11-20T13:47:43.000Z"
        }
    ],
    "pagination": {
        "limit": 4,
        "offset": 0,
        "total": 50
    }
}

​
Request

​
Query

​
type
string
default:"ALL"

Smart list type to fetch - type can be either SAVED, ARCHIVED, NEW or ALL which will return every company.

​
limit
number
default:"4"

Number of items to return per page. (max 500)

​
offset
number
default:"0"

Number of items to skip

​
Response

​
matchedSince
string

The matchedSince is in ISO 8601 date format.

  • For static lists, this represents the date when the item was added to the list.
  • For smart lists, this represents the date the item matched the list’s filters and was added as a new result.
{
    "data": [
        {
            "identifier": {
                "country": "BE",
                "companyNumber": "441571714",
                "name": "TOYOTA MOTOR EUROPE",
                "place": "Evere"
            },
            "matchedSince": "2024-11-20T13:47:43.000Z"
        },
        {
            "identifier": {
                "country": "BE",
                "companyNumber": "403834160",
                "name": "Janssen Pharmaceutica",
                "place": "Beerse"
            },
            "matchedSince": "2024-11-20T13:47:43.000Z"
        },
        {
            "identifier": {
                "country": "BE",
                "companyNumber": "403170701",
                "name": "ELECTRABEL",
                "place": "Bruxelles"
            },
            "matchedSince": "2024-11-20T13:47:43.000Z"
        },
        {
            "identifier": {
                "country": "BE",
                "companyNumber": "416375270",
                "name": "EXXONMOBIL PETROLEUM & CHEMICAL",
                "place": "Antwerpen"
            },
            "matchedSince": "2024-11-20T13:47:43.000Z"
        }
    ],
    "pagination": {
        "limit": 4,
        "offset": 0,
        "total": 50
    }
}