Skip to main content

List products and services

GEThttps://carchost.fieldcontrol.com.br/products-services

Lists the account's products and services, with pagination and filters. The list is sorted by identifier and does not include storageProducts.

Requires the X-Api-Key and User-Agent headers. Limit: 1 request per second (learn more).

Request​

Query parameters

limitinteger

Number of items per page.

From 1 to 100.Default: 10.

offsetinteger

Number of items to skip.

From 0 to 200000.Default: 0.

qstring

Filters in the field:value format, separated by spaces (how to filter). The accepted filters are in the table below.

Example: type:service archived:false.

FilterWhat it does
name

Part of the name, case-insensitive. Up to 50 characters.

type

product or service. Any other value with 7 or 8 characters returns an empty list.

external_id

Identifier in your system (external.id), exactly as registered.

archived

true for archived, false for active.

Headers

User-Agentstringrequired

Identification of your application.

Example: MinhaIntegracao/1.0.

Responses

  • 200

    List of products and services.

  • 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 or pagination (parametersValidationErr).

  • 429

    Limit of 1 request per second exceeded. See Rate limit.

  • 500

    Unexpected server error.