List Companies

GET https://app.alaaqat.com/api/companies

Lists your companies, newest first. Your API key needs the company-index ability.

The list holds the companies the team member who created the key can see in the app: all of them with View All Companies, or only the ones they or their teams own with View Team's Companies or View User's Companies.

Header

{
    "Accept": "application/json"
}

Query parameters

This endpoint accepts the Pagination parameters, with up to 250 companies a page, and supports Complex Filtration.

Key Type Default Description
search string - Search by name.
complex_filters array [] Filter by property values. See Complex Filtration.
forAssociationType string - With forAssociationId, lists only the companies linked to one record. See Associations.
forAssociationId string - The _id of the record whose linked companies you want.

Response

200 OK, or 206 Partial Content when more pages follow. The companies are under data, each with its property values under properties. See Pagination for links and meta.

{
    "data": [
        {
            "properties": {
                "_id": "6655a1b2c3d4e5f6a7b8c901",
                "name": "Blue Harbor Trading",
                "website_url": "https://blueharbor.example.com",
                "industry": "Wholesale",
                "city": "Amman",
                "country_region": "Jordan",
                "phone": "96265000000",
                "num_employees": 45,
                "lifecycle_stage": "customer",
                "owner": 12,
                "created_by": 12,
                "updated_at": "2026-10-20T09:30:00.000000Z",
                "created_at": "2026-10-20T09:30:00.000000Z"
            },
            "account_id": 1024
        },
        {
            "properties": {
                "_id": "6655a1b2c3d4e5f6a7b8c902",
                "name": "Cedar Valley Clinics",
                "website_url": "https://cedarvalley.example.com",
                "industry": "Healthcare",
                "city": "Irbid",
                "country_region": "Jordan",
                "phone": "96227000000",
                "num_employees": 120,
                "lifecycle_stage": "lead",
                "owner": 12,
                "created_by": 12,
                "updated_at": "2026-10-18T11:00:00.000000Z",
                "created_at": "2026-10-18T11:00:00.000000Z"
            },
            "account_id": 1024
        }
    ],
    "links": {
        "first": "https://app.alaaqat.com/api/companies?page=1",
        "last": "https://app.alaaqat.com/api/companies?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "links": [
            {
                "url": null,
                "label": "« Previous",
                "active": false
            },
            {
                "url": "https://app.alaaqat.com/api/companies?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next »",
                "active": false
            }
        ],
        "path": "https://app.alaaqat.com/api/companies",
        "per_page": 15,
        "to": 2,
        "total": 2
    }
}