Get listings

GET /listings

Get listings with filtering

Headers

Query parameters

  • id array[string]

    ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1.

  • external-id array[string]

    External ID(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1, maximum length of each is 255.

  • active boolean

    Status to be considered for filtering

  • tag array[string]

    Tag(s) to be considered for filtering

    At least 1 element. Minimum length of each is 1, maximum length of each is 255.

  • offset string(positive-integer)

    Offset for the results to be returned

    Default value is 0.

  • limit string(positive-integer)

    Limitation for the number of results to be returned

    Default value is 25.

  • Includes deleted resources in the results

Responses

  • 200 application/json

    Successful operation

    Hide response attributes Show response attributes object
    • data array[object] Required
      Hide data attributes Show data attributes object
      • id string Required

        Minimum length is 1.

      • name object | null Required

        Additional properties are NOT allowed.

        Hide name attributes Show name attributes object | null
        • language string Required

          Values are da, de, el, en, es, fr, ja, nl, no, or pl.

        • value string Required
      • description object | null Required

        Additional properties are NOT allowed.

        Hide description attributes Show description attributes object | null
        • language string Required

          Values are da, de, el, en, es, fr, ja, nl, no, or pl.

        • value string Required
      • externalId string | null

        Minimum length is 1, maximum length is 255.

      • active boolean Required
      • tags array[string] Required

        Minimum length of each is 1.

      • timeZone string Required

        Minimum length is 1.

      • createdAt string(date-time) Required

        Minimum length is 1.

      • updatedAt string(date-time) Required

        Minimum length is 1.

      • deletedAt string(date-time) | null Required

        Minimum length is 1.

      • location object | null

        Additional properties are NOT allowed.

        Hide location attributes Show location attributes object | null
        • city object | null Required

          Additional properties are NOT allowed.

          Hide city attributes Show city attributes object | null
          • language string Required

            Values are da, de, el, en, es, fr, ja, nl, no, or pl.

          • value string Required
        • state object | null Required

          Additional properties are NOT allowed.

          Hide state attributes Show state attributes object | null
          • language string Required

            Values are da, de, el, en, es, fr, ja, nl, no, or pl.

          • value string Required
        • street1 object | null Required

          Additional properties are NOT allowed.

          Hide street1 attributes Show street1 attributes object | null
          • language string Required

            Values are da, de, el, en, es, fr, ja, nl, no, or pl.

          • value string Required
        • street2 object | null Required

          Additional properties are NOT allowed.

          Hide street2 attributes Show street2 attributes object | null
          • language string Required

            Values are da, de, el, en, es, fr, ja, nl, no, or pl.

          • value string Required
        • postalCode string | null

          Minimum length is 1.

        • countryCode string Required

          Minimum length is 2, maximum length is 2.

        • formattedAddress string Required

          Minimum length is 1.

        • geolocation object Required

          Additional properties are NOT allowed.

          Hide geolocation attributes Show geolocation attributes object
          • latitude number Required

            Minimum value is -90, maximum value is 90.

          • longitude number Required

            Minimum value is -180, maximum value is 180.

    • meta object Required

      Additional properties are NOT allowed.

      Hide meta attributes Show meta attributes object
      • offset integer Required

        Minimum value is 0. Default value is 0.

      • limit integer Required

        Minimum value is 0. Default value is 25.

      • totalCount integer Required

        Minimum value is 0.

GET /listings
curl \
 -X GET https://api.development.pexipengage.com/enterprises/acme/listings \
 -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" \
 -H "X-Correlation-Id: a4f0048e-c983-11ed-afa1-0242ac120002" \
 -H "Accept-Language: en *"
Response examples (200)
{
  "data": [
    {
      "id": "123",
      "name": {
        "language": "en",
        "value": "Lorem ipsum"
      },
      "description": {
        "language": "en",
        "value": "Lorem ipsum"
      },
      "externalId": "ABCD1234",
      "active": true,
      "tags": [
        "string"
      ],
      "timeZone": "Europe/Brussels",
      "createdAt": "2022-08-17T19:05:21.362Z",
      "updatedAt": "2022-08-17T19:05:21.362Z",
      "deletedAt": "2022-08-17T19:05:21.362Z",
      "location": {
        "city": {
          "language": "en",
          "value": "Lorem ipsum"
        },
        "state": {
          "language": "en",
          "value": "Lorem ipsum"
        },
        "street1": {
          "language": "en",
          "value": "Lorem ipsum"
        },
        "street2": {
          "language": "en",
          "value": "Lorem ipsum"
        },
        "postalCode": "9000",
        "countryCode": "BE",
        "formattedAddress": "string",
        "geolocation": {
          "latitude": 51.0479466,
          "longitude": 3.6912248
        }
      }
    }
  ],
  "meta": {
    "offset": 0,
    "limit": 25,
    "totalCount": 42
  }
}