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

# Get Emails

> Retrieve emails associated with a callout

Retrieve all emails associated with a specific callout ID.

<Note>
  This endpoint returns `false` if no emails exist for the given callout ID, or
  an array of email objects if emails are found.
</Note>

## Request

<ParamField query="callout_id" type="string" required>
  The unique identifier of the callout to retrieve emails for
</ParamField>

<ParamField header="Authorization" type="string" required>
  Bearer token for API authentication
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
       --url https://api.credira.com/v1/emails?callout_id=callout_987654321 \
       --header 'Authorization: Bearer YOUR_API_KEY' \
       --header 'Content-Type: application/json'
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch(
    "https://api.credira.com/v1/emails?callout_id=callout_987654321",
    {
      method: "GET",
      headers: {
        Authorization: "Bearer YOUR_API_KEY",
        "Content-Type": "application/json",
      },
    }
  );

  const data = await response.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample status="200" summary="Success">
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "email_123456789",
        "callout_id": "callout_987654321",
        "subject": "Payment Reminder - Invoice #INV-001",
        "recipient_email": "customer@example.com",
        "recipient_name": "John Doe",
        "status": "delivered",
        "template_id": "template_456789123",
        "template_name": "Payment Reminder Template",
        "sent_time": "2024-01-15T10:30:00Z",
        "opened_time": "2024-01-15T11:15:00Z",
        "clicked_time": "2024-01-15T11:20:00Z",
        "bounced": false,
        "unsubscribed": false,
        "account_id": "acc_789123456",
        "created_time": "2024-01-15T10:25:00Z",
        "email_type": "payment_reminder",
        "priority": "high",
        "metadata": {
          "campaign_id": "camp_123",
          "department": "billing",
          "invoice_amount": 1250.0
        }
      }
    ],
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789",
      "total_emails": 1
    }
  }
  ```
</ResponseExample>

<ResponseExample status="400" summary="Bad Request">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "code": "INVALID_REQUEST",
      "message": "Missing required parameter: callout_id"
    },
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789"
    }
  }
  ```
</ResponseExample>

<ResponseExample status="401" summary="Unauthorized">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "code": "UNAUTHORIZED",
      "message": "Invalid or missing API key"
    },
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789"
    }
  }
  ```
</ResponseExample>

<ResponseExample status="404" summary="Not Found">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "code": "NOT_FOUND",
      "message": "Callout not found"
    },
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789"
    }
  }
  ```
</ResponseExample>

<ResponseExample status="429" summary="Too Many Requests">
  ```json theme={null}
  {
    "success": false,
    "error": {
      "code": "RATE_LIMITED",
      "message": "Rate limit exceeded"
    },
    "meta": {
      "timestamp": "2024-01-15T10:30:00Z",
      "request_id": "req_123456789"
    }
  }
  ```
</ResponseExample>