List equipment
https://carchost.fieldcontrol.com.br/equipmentsLists the account's equipment, with pagination, filters and sorting. The list does not include customFields, labels or status.
Requires the
X-Api-KeyandUser-Agentheaders. Limit: 1 request per second (learn more).
Request
Query parameters
limitintegerNumber of items per page.
From 1 to 100.Default: 10.
offsetintegerNumber of items to skip.
From 0 to 200000.Default: 0.
qstringFilters in the field:value format, separated by spaces (how to filter). The accepted filters are in the table below.
Example: customer_id:NTc4NTQ1OjIyOTE1 archived:false.
| Filter | What it does |
|---|---|
number | Serial number, exactly as registered. From 4 to 150 characters. |
customer_id | Customer identifier. |
location_id | Identifier of the customer location. |
type_id | Equipment type identifier. |
storage_id | Storage identifier. |
archived |
|
created_at | Creation date equal to the given date (ISO 8601, UTC). |
created_at>= | Created on or after the given date. |
created_at<= | Created on or before the given date. |
created_at> | Created after the given date. |
created_at< | Created before the given date. |
sortstringSorting. -created_at sorts from newest to oldest.
Accepted values: id, created_at, -created_at.Default: id.
Headers
User-AgentstringrequiredIdentification of your application.
Example: MinhaIntegracao/1.0.
Responses
- 200
List of equipment.
- 401
API key missing (
Missing API Key) or invalid (Invalid API Key). See Authentication. - 403
Account blocked (
Account blocked), expired (Account expired) or on a plan that does not allow integration (Account plan not allowed). See Authentication. - 422
Invalid filter, pagination or sorting (parametersValidationErr).
- 429
Limit of 1 request per second exceeded. See Rate limit.
- 500
Unexpected server error.