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

# Check Availability

> Returns available pickup time slots for a given zip code over the next 14 days

## Request Parameters

### Query Parameters

<ParamField query="zip_code" type="string" required>
  The zip code to check for available pickup time slots
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl -X GET \
    'https://platform.returnqueen.dev/api/availability?zip_code=11201' \
    -H 'X-API-KEY: your-api-key'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "time_slots": [
      {
        "date": "2024-01-15",
        "slots": [
          {
            "start_time": "2024-01-15T14:00:00Z",
            "end_time": "2024-01-15T18:00:00Z"
          },
          {
            "start_time": "2024-01-15T18:00:00Z",
            "end_time": "2024-01-15T22:00:00Z"
          }
        ]
      },
      {
        "date": "2024-01-16",
        "slots": [
          {
            "start_time": "2024-01-16T14:00:00Z",
            "end_time": "2024-01-16T18:00:00Z"
          }
        ]
      }
    ]
  }
  ```
</ResponseExample>

## Response Fields

<ResponseField name="time_slots" type="array">
  List of dates with their available time slots

  <Expandable title="day slot properties">
    <ResponseField name="date" type="string">
      Date in ISO 8601 format (YYYY-MM-DD)
    </ResponseField>

    <ResponseField name="slots" type="array">
      List of available time slots for this date

      <Expandable title="time slot properties">
        <ResponseField name="start_time" type="string">
          Start time of the slot in ISO 8601 format
        </ResponseField>

        <ResponseField name="end_time" type="string">
          End time of the slot in ISO 8601 format
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  This endpoint returns pickup availability for the next 14 days. Time slots are returned in UTC format.
</Note>