# GET /companies

**Resource:** [Companies](./companies.md)  
**Scopes:** `companies:read`  
**Write operation:** no

List all companies with cursor-based pagination. Legacy alias: GET /customers.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `search` | query | string | no | Search by name, email, or phone |
| `limit` | query | number | no | Max results (1-100, default 25) |
| `cursor` | query | string | no | Cursor for next page |

## Request example

```bash
curl -X GET \
  "https://api.trustpager.com/functions/v1/api/v1/companies?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response example

```json
{
  "data": [
    {
      "id": "company-uuid-...",
      "public_id": "A-001",
      "name": "Acme Corp",
      "email": "info@acme.com",
      "phone": "+61412345678",
      "landline": "+61290001234",
      "industry": "Construction",
      "created_at": "2026-01-10T09:00:00Z"
    }
  ],
  "pagination": { "limit": 10, "has_more": false, "next_cursor": null, "prev_cursor": null },
  "meta": { "credits_remaining": 9500 }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`