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.
{
"Accept": "application/json"
}
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. |
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
}
}