---
title: "Get inquiry by id"
method: GET
path: "/v2/inquiries/{id}"
tags: ["Inquiries"]
---

# Get inquiry by id

`GET /v2/inquiries/{id}`

## Request

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

Look up one inquiry by its ID. An inquiry is a caller's question or request that your team needs to follow up on.

## Path parameters

- `id` string, uuid, required: Inquiry ID

## Response `200`

GET /v2/inquiries/:id Positive response

- GetV2InquiriesIdPositiveResponse: Full inquiry with related customer and call data
  - `id` string, uuid, required
  - `createdAt` string, date-time, nullable, required: Inquiry creation time. ISO 8601 timestamp
  - `updatedAt` string, date-time, nullable, required: Inquiry last update time. ISO 8601 timestamp
  - `customerCampaignId` string, uuid, required
  - `callId` string, uuid, nullable, required
  - `toolCallId` string, nullable, required
  - `duplicateOfId` string, uuid, nullable, required
  - `inquiry` string, required
  - `response` string, nullable, required
  - `status` 'new' | 'pending_resolution' | 'unresolved' | 'resolved' | 'appointment_scheduled' | 'duplicate', required
  - `primaryCategory` string, nullable, required
  - `subcategory` string, nullable, required
  - `severity` string, nullable, required
  - `severityTriggers` union, required
    - string
    - number
    - boolean
    - object
    - unknown[]
      - unknown
  - `priority` integer, nullable, required
  - `priorityRationale` string, nullable, required
  - `priorityCategory` string, nullable, required
  - `priorityConfidence` integer, nullable, required
  - `priorityRank` integer, nullable, required
  - `suggestedHandling` string, nullable, required
  - `handlingRationale` string, nullable, required
  - `reasoning` string, nullable, required
  - `escalationApplied` boolean, nullable, required
  - `additionalConcerns` union, required
    - string
    - number
    - boolean
    - object
    - unknown[]
      - unknown
  - `resolutionType` string, nullable, required
  - `notes` string, nullable, required
  - `resolvedAt` string, date-time, nullable, required: Inquiry resolution time. ISO 8601 timestamp
  - `resolvedBy` string, uuid, nullable, required
  - `assignedTo` string, uuid, nullable, required
  - `callbackRequestedAt` string, date-time, nullable, required: Callback request time. ISO 8601 timestamp
  - `callbackRequestedBy` string, uuid, nullable, required
  - `callbackWorkflowId` string, uuid, nullable, required
  - `callbackCompletedAt` string, date-time, nullable, required: Callback completion time. ISO 8601 timestamp
  - `callbackCallId` string, uuid, nullable, required
  - `callbackDisposition` string, nullable, required
  - `callbackFailureReason` string, nullable, required
  - `callbackScheduledFor` string, date-time, nullable, required: Scheduled callback time. ISO 8601 timestamp
  - `carrierName` string, nullable, required
  - `planName` string, nullable, required
  - `planCode` string, nullable, required
  - `agentName` string, nullable, required
  - `firstName` string, nullable, required
  - `lastName` string, nullable, required
  - `callerId` 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
  - `customer` object, nullable, required: Customer data associated with the inquiry
    - `id` string, required
    - `email` string, nullable, required
    - `dateOfBirth` string, date, nullable, required: Customer date of birth. Canonical format: YYYY-MM-DD
    - `state` string, nullable, required
    - `city` string, nullable, required
    - `postalCode` string, nullable, required
    - `address` string, nullable, required
    - `language` string, nullable, required
    - `timezone` string, nullable, required
    - `enrollmentDate` string, date, nullable, required: Customer enrollment date. Canonical format: YYYY-MM-DD
    - `effectiveDate` string, date, nullable, required: Customer coverage effective date. Canonical format: YYYY-MM-DD
    - `veteran` boolean, nullable, required
    - `medicareCard` string, nullable, required
    - `medicaid` string, nullable, required
    - `socialSecurityDisability` boolean, nullable, required
    - `existingCoverage` string, nullable, required
    - `desiredCoverageStart` string, date, nullable, required: Desired coverage start date. Canonical format: YYYY-MM-DD
    - `subsidyAmount` number, nullable, required
    - `householdIncome` number, nullable, required
    - `filingStatus` string, nullable, required
    - `doNotCall` boolean, nullable, required
    - `doNotSMS` boolean, nullable, required
    - `doNotEmail` boolean, nullable, required
    - `doNotMail` boolean, nullable, required
  - `call` object, nullable, required: Call data associated with the inquiry
    - `id` string, required
    - `callerId` string, nullable, required
    - `createdAt` string, date-time, nullable, required: Call creation time. ISO 8601 timestamp
    - `disposition` string, nullable, required
    - `durationMs` number, nullable, required
    - `assistantType` string, nullable, required
    - `summary` string, nullable, required
    - `transcript` string, nullable, required
    - `direction` string, nullable, required
    - `cost` number, nullable, required
    - `successEvaluation` string, nullable, required
    - `endedReason` string, nullable, required
    - `testFlag` boolean, nullable, required

## Other responses

- `400`: GET /v2/inquiries/:id Negative response 400
- `401`: GET /v2/inquiries/:id Negative response 401
- `403`: GET /v2/inquiries/:id Negative response 403
- `404`: GET /v2/inquiries/:id Negative response 404
- `409`: GET /v2/inquiries/:id Negative response 409
- `422`: GET /v2/inquiries/:id Negative response 422
- `429`: GET /v2/inquiries/:id Negative response 429
- `500`: GET /v2/inquiries/:id Negative response 500
- `502`: GET /v2/inquiries/:id Negative response 502
- `503`: GET /v2/inquiries/:id 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)
