---
title: "List inquiries"
method: GET
path: "/v2/inquiries"
tags: ["Inquiries"]
---

# List inquiries

`GET /v2/inquiries`

## Request

- Base URL: `https://api.carecycle.ai`
- URL: `https://api.carecycle.ai/v2/inquiries`
- Auth: API key in header `x-api-key`

List inquiries: questions or requests from callers that your team needs to follow up on. You can filter by status.

## Query parameters

- `page` number
- `perPage` number
- `status` string: Filter inquiries by status. Single value or comma-separated list (e.g. 'new' or 'new,pending_resolution,unresolved')
- `agentName` string: Filter inquiries by agent name
- `assignedTo` string: Filter inquiries by assigned user. Single user id or comma-separated list of user ids.
- `priority` '1' | '2' | '3' | '4' | '5' | 'none': Filter to one priority tier, or 'none' for unscored inquiries
- `customerId` string, uuid: Filter inquiries to a single customer
- `search` string: Search inquiries by customer name or phone number
- `sortBy` string: Column to sort by. Supported: 'createdAt' (default), 'priority'. Unknown values fall back to createdAt.
- `sortDirection` 'asc' | 'desc': Sort direction, defaults to desc. For 'priority', direction describes urgency: desc = most urgent (P1) first.

## Response `200`

GET /v2/inquiries Positive response

- GetV2InquiriesPositiveResponse
  - `itemsTotal` number, required
  - `currentPage` number, required
  - `nextPage` number, nullable, required
  - `prevPage` number, nullable, required
  - `items` object[], required: List of inquiries
    - `id` string, required
    - `customerCampaignId` string, required
    - `callId` string, nullable, required
    - `duplicateOfId` string, nullable, required
    - `inquiry` string, required
    - `status` string, required
    - `primaryCategory` string, nullable, required
    - `severity` string, nullable, required
    - `priority` integer, nullable, required
    - `priorityRationale` string, nullable, required
    - `priorityCategory` string, nullable, required
    - `priorityConfidence` integer, nullable, required
    - `resolvedAt` string, date-time, nullable, required: Inquiry resolution time. ISO 8601 timestamp
    - `createdAt` string, date-time, nullable, required: Inquiry creation time. ISO 8601 timestamp
    - `response` string, nullable, required
    - `notes` string, nullable, required
    - `resolutionType` string, nullable, required
    - `callbackRequestedAt` string, date-time, nullable, required: Callback request time. ISO 8601 timestamp
    - `callbackScheduledFor` string, date-time, nullable, required: Scheduled callback time. ISO 8601 timestamp
    - `callbackCompletedAt` string, date-time, nullable, required: Callback completion time. ISO 8601 timestamp
    - `callbackDisposition` string, nullable, required
    - `callbackFailureReason` string, nullable, required
    - `customerId` string, uuid, nullable, required
    - `customerName` string, nullable, required
    - `callerId` string, nullable, required
    - `customerTimezone` string, nullable, required
    - `customerPostalCode` string, nullable, required
    - `agentName` string, nullable, required
    - `carrierName` string, nullable, required
    - `planName` string, nullable, required
    - `campaign` object, nullable, required: Campaign data associated with the inquiry
      - `id` string, required
      - `name` string, required
      - `templateId` string, uuid, nullable, required
      - `status` string, required
      - `createdAt` string, date-time, nullable, required: Campaign creation time. ISO 8601 timestamp
      - `description` string, nullable, required
    - `assignedUser` object, nullable, required: User the inquiry is assigned to
      - `id` string, uuid, required
      - `name` string, nullable, required
      - `image` string, nullable, required
    - `customerAssignedUser` object, nullable, required: User the customer is assigned to
      - `id` string, uuid, required
      - `name` string, nullable, required
      - `image` string, nullable, required

## Other responses

- `400`: GET /v2/inquiries Negative response 400
- `401`: GET /v2/inquiries Negative response 401
- `403`: GET /v2/inquiries Negative response 403
- `404`: GET /v2/inquiries Negative response 404
- `409`: GET /v2/inquiries Negative response 409
- `422`: GET /v2/inquiries Negative response 422
- `429`: GET /v2/inquiries Negative response 429
- `500`: GET /v2/inquiries Negative response 500
- `502`: GET /v2/inquiries Negative response 502
- `503`: GET /v2/inquiries Negative response 503

---

[API](https://skmtc.dev/carecycle/apis/carecycle-public-api.md) - [All operations](https://skmtc.dev/carecycle/apis/carecycle-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/carecycle/apis/carecycle-public-api/revisions/db390c743c36?raw)