# List Global Trade Items

Provide a list of Global Trade Items with optional filtering and pagination.

Endpoint: GET /globaltradeitems
Version: 1
Security: apiKey

## Query parameters:

  - `startAfter` (string)
    Use nextStartAfter provided in the response of previous call as an indicator for a next page.
    Example: "NjI4ZGNkZjAzYjlkMjY4NjhlNjQxNDRm"

  - `limit` (integer)
    Number of items to be returned on the page.
    Example: "500"

  - `businessPartnerIds` (array)
    Filter Global Trade Items by Business Partners ID that are referenced.
    Example: ["63e635235c06b7396330fe40"]

  - `featuresOn` (array)
    Features to be turned on:
*  - Includes businessPartnerReferences. By default, turned off.
*  - Allows switching fetching the total number of Global Trade Items to improve performance. By default turned off.
    Enum: "FETCH_BUSINESS_PARTNER_RELATIONS", "NUMBER_OF_TOTAL"

## Response 200 fields (application/json):

  - `total` (integer)
    Total number of items which can be paged.
    Example: "67"

  - `limit` (integer)
    Number of items per page.
    Example: "100"

  - `startAfter` (string)
    The ID which is used to read the page.
    Example: "5712566172571652"

  - `nextStartAfter` (string)
    Provides a value to be used as a startAfter in next page request.
    Example: "5712566172571652"

  - `values` (array)
    List of Global Trade Items.

  - `values.gtin` (string)
    A 13 digit Global Trade Item Number that uniquely identifies the item
    Example: "5099206081901"

  - `values.name` (string)
    Human readable name of the item.
    Example: "Business Partner Update Browser"

  - `values.businessPartnerReferences` (array)
    List of Business Partners that are referenced.

  - `values.businessPartnerReferences.storageId` (string)
    Unique identifier of the Storage.
    Example: "72d6900fce6b326088f5d9d91049e3e6"

  - `values.businessPartnerReferences.dataSourceId` (string)
    Unique identifier for a Data Source of the Storage.
    Example: "648824a691d8d2503d65103e"

  - `values.businessPartnerReferences.businessPartnerId` (string)
    A CDQ ID identifies a business partner uniquely in the context of the Corporate Data League.
    Example: "63e635235c06b7396330fe40"

  - `values.businessPartnerReferences.externalId` (string)
    Arbitrary identifier type to mark customer IDs that are "external" from CDQ's perspective. This is the identifier a customer provides to identify its records.
    Example: "The ID managed in the customer's SAP systems."