---
updatedAt: 2025-07-30T16:15:25.000Z
agentTools:
  projectIndex: https://docs.supplierxm.salsify.com/llms.txt
---

# List Event

## List of errors

All errors will follow this pattern :

```json
{
    "message": "You don't have the permission to perform this action",
    "status": 403,
    "data": {
        ...
    }
}
```

You will often find more details in the `data` object and when there are several errors on a bulk update, you will find the list of errors in the `errors` array.

<HTMLBlock>{`
<table class="errors-table">
    <thead>
        <tr>
            <th>Status</th>
            <th>Message</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td rowspan=1>403</td>
            <td>You don't have the permission to perform this action</td>
        </tr>
        <tr>
            <td rowspan=1>500</td>
            <td>Internal server error</td>
        </tr>
    </tbody>
</table>

<style>
	.errors-table td {
    text-align: center;
  }
  .errors-table td:last-of-type {
    text-align: left;
  }
</style>
`}</HTMLBlock>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "tenders-public-retailer",
    "version": "2.1"
  },
  "servers": [
    {
      "url": "https://apis.supplierxm.salsify.com/rfp/public/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "x-default": "SALSIFY_TOKEN",
        "name": "Authorization",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/events": {
      "get": {
        "summary": "List Event",
        "description": "",
        "operationId": "list-event-retailer",
        "parameters": [
          {
            "name": "uuids",
            "in": "query",
            "description": "List of filtered event uuids",
            "schema": {
              "type": "string",
              "default": "UUID_1,UUID_2"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "The index of the first event to be returned.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of events to be returned.",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 20
            }
          },
          {
            "name": "start_date",
            "in": "query",
            "description": "Filter events which start at a certain date",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "Filter events which end at a certain date",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "from_last_updated_at",
            "in": "query",
            "description": "Filter events for which the data has been updated at a certain date/time.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "to_last_updated_at",
            "in": "query",
            "description": "Filter events for which the data has been updated at a certain date/time.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"events\": [\n    {\n      \"uuid\": \"UNIQUE-ID-1\",\n      \"code\": \"EVENT-CODE-1\",\n      \"data\": {\n        \"descriptionText\": [\n          {\n            \"data\": \"EVENT NAME 1\",\n            \"expressedIn\": {\n              \"code\": \"fra-FR\",\n              \"rank\": null,\n              \"label\": \"fra-FR\",\n              \"description\": \"fra-FR\",\n              \"expressedIn\": [],\n              \"_type\": \"Language\",\n              \"data\": {\n                \"locale\": \"fr_FR\",\n                \"GDSN3.1\": \"fr-250\",\n                \"GDSN2.8\": \"fr-250\"\n              },\n              \"normalizedCode\": \"fr\"\n            }\n          }\n        ],\n        \"startDate\": \"2022-04-01\",\n        \"endDate\": \"2022-04-30\"\n      },\n    },\n    {\n      \"uuid\": \"UNIQUE-ID-2\",\n      \"code\": \"EVENT-CODE-2\",\n      \"data\": {\n        \"descriptionText\": [\n          {\n            \"data\": \"EVENT NAME 2\",\n            \"expressedIn\": {\n              \"code\": \"fra-FR\",\n              \"rank\": null,\n              \"label\": \"fra-FR\",\n              \"description\": \"fra-FR\",\n              \"expressedIn\": [],\n              \"_type\": \"Language\",\n              \"data\": {\n                \"locale\": \"fr_FR\",\n                \"GDSN3.1\": \"fr-250\",\n                \"GDSN2.8\": \"fr-250\"\n              },\n              \"normalizedCode\": \"fr\"\n            }\n          }\n        ],\n        \"startDate\": \"2022-04-01\",\n        \"endDate\": \"2022-04-23\"\n      },\n    }\n  ],\n  \"totalResults\": number of events\n}"
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```