> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Batches

> Retrieve a list of all batches created by your organization.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Query Parameters

<ParamField query="take" type="integer">
  Optional. The number of results to return.
</ParamField>

<ParamField query="skip" type="integer">
  Optional. The number of results to skip (used for pagination).
</ParamField>

### Response

<ResponseField name="data" type="array">
  A list of batches created by your organization.
</ResponseField>

<ResponseField name="data[].id" type="string">
  The unique identifier of the batch.
</ResponseField>

<ResponseField name="data[].user_id" type="string">
  The ID of the org that created the batch.
</ResponseField>

<ResponseField name="data[].base_prompt" type="string">
  A JSON string representing the global call properties used in the batch.
</ResponseField>

<ResponseField name="data[].created_at" type="string (ISO 8601)">
  The timestamp when the batch was created.
</ResponseField>

<ResponseField name="data[].call_objects" type="array">
  A preview of the call objects included in the batch.
</ResponseField>

<ResponseField name="data[].description" type="string">
  A human-readable description of the batch.
</ResponseField>

<ResponseField name="errors" type="null">
  Always `null` on success.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "652ad643-9gca-477c-97c3-9d8e6t74d7af",
        "user_id": "64602f94-d670-43d2-8474-bcdcb9522c4f",
        "base_prompt": "{\"record\":true,\"task\":\"Say hello to the user\"}",
        "created_at": "2025-05-08T19:28:12.627Z",
        "call_objects": [
          {
            "task": "Say hello to the user",
            "phone_number": "+1234567890"
          }
        ],
        "description": "My first batch"
      }
    ],
    "errors": null
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)