# Get batch details

Retrieve per-session details for a batch, including the current state of each call session in the batch.
Use this endpoint when individual session-level visibility is needed (for example, to inspect which sessions are `QUEUED`, `IN_PROGRESS` or `COMPLETED`). `EXPIRED` sessions are never returned because they were never initiated.

Endpoint: GET /v2/projects/{projectId}/batches/{batchId}/details
Version: 2.0.59
Security: BasicAuth, SinchOAuth2

## Security:

  - `BasicAuth` (unknown)
    http basic

  - `SinchOAuth2` (unknown)
    oauth2

## Path parameters:

  - `projectId` (string, required)
    The ID of the project.

  - `batchId` (string, required)
    The ID of the batch.

## Response 200:

  - `200` (unknown)
    Batch details

## Response 200 fields (application/json):

  - `sessions` (array, required)

  - `sessions.id` (string)
    Unique identifier of the call session within the batch. This identifies the session, not an individual call. Use it with  `/v2/projects/{projectId}/sessions/{sessionId}` to retrieve full session details.

  - `sessions.state` (string)
    The state of the current session. Sessions can either be in a "transitional" or "final" state.  Sessions in a transitional state are ongoing. Sessions in a final state have will not send any  more events.
    Enum: "QUEUED", "IN_PROGRESS", "COMPLETED", "EXPIRED"

  - `sessions.parameters` (object)
    Plain key-value set of parameters from the batch request `parameters` entry that was used to initiate this call session.

## Response 400:

  - `400` (unknown)
    Invalid request parameters.

## Response 400 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/bad-request"

  - `title` (any, required)
    Enum: "Bad Request"

  - `detail` (any, required)
    Example: The request body is invalid or malformed.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

## Response 401:

  - `401` (unknown)
    Authentication failed — token missing, invalid, or expired.

## Response 401 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/unauthorized"

  - `title` (any, required)
    Enum: "Unauthorized"

  - `detail` (any, required)
    Example: The token is missing, invalid, or has expired.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

## Response 401 headers (application/problem+json):

  - `WWW-Authenticate` (string)
    RFC 7235 challenge. Indicates the required authentication scheme and, for expired tokens, provides an error hint.
    Example: Bearer realm="sinch", error="invalid_token", error_description="Token has expired"

## Response 403:

  - `403` (unknown)
    Forbidden.

## Response 403 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/forbidden"

  - `title` (any, required)
    Enum: "Forbidden"

  - `detail` (any, required)
    Example: The request was rejected.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

## Response 404:

  - `404` (unknown)
    Resource not found.

## Response 404 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/not-found"

  - `title` (any, required)
    Enum: "Not Found"

  - `detail` (any, required)
    Example: The requested resource was not found.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

## Response 429:

  - `429` (unknown)
    Too many requests — rate limit exceeded.

## Response 429 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/too-many-requests"

  - `title` (any, required)
    Enum: "Too Many Requests"

  - `detail` (any, required)
    Example: Rate limit exceeded. Please slow down your request rate and retry after the indicated period.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls

## Response 429 headers (application/problem+json):

  - `Retry-After` (integer)
    Number of seconds to wait before retrying the request.
    Example: 60

## Response 500:

  - `500` (unknown)
    Internal server error occurred.

## Response 500 fields (application/problem+json):

  - `type` (any, required)
    Enum: "https://api.sinch.com/docs/errors/internal-server-error"

  - `title` (any, required)
    Enum: "Internal Server Error"

  - `detail` (any, required)
    Example: An unexpected error occurred on the server.

  - `instance` (any, required)
    Example: /v2/projects/5c5bf2b1-35ae-4825-ab89-457e07bb60e6/calls/01ARZ3NDEKTSV4RRFFQ69G5FAA

