# Get the status of batches by metadata

Retrive the status of batches that match the metadata provided.

Endpoint: GET /v1/projects/{project_id}/messages
Version: 1.0
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    http bearer

## Path parameters:

  - `project_id` (string, required)
    The unique ID of the project. You can find this on the [Sinch Dashboard](https://dashboard.sinch.com/convapi/apps).

## Query parameters:

  - `metadataKey` (string, required)
    The key of the metadata to filter batches by.

  - `metadataValue` (string, required)
    The value of the metadata to filter batches by.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `batch_id` (string)
    The ID of the batch of messages.

  - `meta_data` (object)
    The metadata associated with the batch of messages.

  - `status` (string)
    The status of the batch of messages.
    Enum: "READY", "SCHEDULED", "PROCESSED", "CANCELLED"

  - `send_after` (string)
    The date and time when the batch of messages is or was scheduled to be sent to recipients.

## Response 401:

  - `401` (unknown)
    Invalid credentials

## Response 403:

  - `403` (unknown)
    Permission denied. The specified project may not be allowed to use the batch endpoint.

## Response 500:

  - `500` (unknown)
    Internal error

## Response 500 fields (application/json):

  - `code` (integer)

  - `message` (string)

  - `status` (string)

  - `details` (array)

## Response 500 examples:

  - `Internal error` (unknown)