List the messages of a container

Méthode GET https://<client-api-host>/api/v3.1/containers/{crid}/messages

List the messages of a container: the primary message first, then by creation date. Replies are not listed. The fields depend on the platform messageAccess setting (see the API description).

Autorisation

Scope requis messages:read

Use Authorization: Bearer liv_<prefix>_<secret>. The key must belong to a platform served by the V3 pipeline; otherwise every route answers 403 PLATFORM_NOT_V3.

Paramètres

Nom	Emplacement	Type	Requis	Contraintes	Description
`crid`	Chemin	`string`	Requis		Your business reference of the container.
`mrid`	Paramètre de requête	`string`	Facultatif		Exact filter on your message reference.
`state`	Paramètre de requête	`V31MessageState`	Facultatif		Valeurs `rejected` `held` `failed` `processing` `hidden` `pending_review` `published`
`limit`	Paramètre de requête	`integer`	Facultatif	min 1, max 200	Par défaut `50`
`skip`	Paramètre de requête	`integer`	Facultatif	min 0	Par défaut `0`

Réponses

200 application/json Schéma V31MessageList

Paginated list of messages.

400 application/json Schéma V31ErrorEnvelope

Invalid payload, unknown field or invalid value.

json 400

{
  "error": {
    "code": "DATA_INVALID",
    "message": "Invalid field crid"
  }
}

401 application/json Schéma V31ErrorEnvelope

Authentication failed or missing bearer token.

json 401

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Missing API key"
  }
}

403 application/json Schéma V31ErrorEnvelope

Authenticated but not allowed: missing scope (FORBIDDEN), invalid platform constraints (INVALID_PLATFORM_CONSTRAINTS) or a platform not served by API v3.1 (PLATFORM_NOT_V3).

json 403

{
  "error": {
    "code": "PLATFORM_NOT_V3",
    "message": "Platform is not served by API v3.1"
  }
}

404 application/json Schéma V31ErrorEnvelope

Container not found for this crid on the platform of the key.

json 404

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Container not found"
  }
}

429 application/json Schéma V31ErrorEnvelope

Rate limit exceeded.

json 429

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests"
  }
}

500 application/json Schéma V31ErrorEnvelope

Unexpected server error.

json 500

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "Internal error"
  }
}