get
https://api.customerly.io/v2/companies
Returns a paginated list of companies for your app.
Pagination
This endpoint uses offset-based pagination:
per_page: Number of companies to return per page (default: 20, max: 100)cursor: The cursor value from the previous response to fetch the next page
Example pagination flow:
- First request:
GET /companies?per_page=20 - Response returns a
cursorvalue (e.g.,20) and 20 companies - Next page:
GET /companies?per_page=20&cursor=20 - Continue until
cursorisnull(no more companies available)
The cursor is the offset of the next page, not a company ID. Keep the other query parameters
identical across pages, otherwise the offset points at a different result set.
Filtering
keyword: Search companies by name (optional)
For anything more than a name search — combining conditions with and/or, filtering on company
attributes or segment membership — use POST /companies/filter.
Response
Companies are ordered by company_id in descending order (newest first).
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
401Authentication required
422Invalid request parameters