GET https://ed.link/api/v2/companies
Retrieve a list of public Companies.
You must provide an application's publishable key (pk_...) as a bearer token to access this endpoint.
Request Parameters
This query allows for standard paging parameters.
It is best practice to use either $first or $last in conjunction with the $next value returned by the API to paginate through results.
Read More About Paging
Developer Guide
This query allows for filtering results.
Read More About Filtering
Developer Guide
This query also allows for fuzzy searching.
| Parameter | Type | Description |
|---|---|---|
$search | string | A search term used to fuzzy-match companies by name and by address city, state, or postal code. Results are ordered by name similarity. Cannot be combined with cursor pagination ($after or $before). |
$offset | integer | Offset for paginating $search results. Defaults to 0. Ignored without $search. |
$expand | string | A comma separated list of relationships to join onto the parent entity |
When browsing with $search use $offset to page through results instead of $after or $before.
Sample Request
// List companies.
axios.get('https://ed.link/api/v2/companies', {
headers: {
authorization: `Bearer ${publishable_key}`
}
});
// Search for companies matching "Acme".
axios.get('https://ed.link/api/v2/companies', {
params: {
$search: 'Acme',
$first: 25
},
headers: {
authorization: `Bearer ${publishable_key}`
}
});
Sample Response
{
"$data": [
{
"id": "00000000-0000-0000-0000-000000000000",
"name": "Acme Learning",
"website": "https://acme.example.com",
"description": "An educational technology company.",
"logo": null
},
{
"id": "11111111-1111-1111-1111-111111111111",
"name": "Acme Publishing",
"website": "https://acme-publishing.example.com",
"description": null,
"logo": null
}
],
"$next": "https://ed.link/api/v2/companies?$cursor=...",
"$request": "00000000-0000-0000-0000-000000000000"
}