---
title: "Resolve Shortcode"
method: GET
path: "/calls/shortcode/{shortcode}"
tags: ["Calls"]
---

# Resolve Shortcode

`GET /calls/shortcode/{shortcode}`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/calls/shortcode/{shortcode}`
- Auth: none declared

Resolve a shortcode to the record it points at.

A shortcode targets a call, a chat conversation or an intake form session.
This endpoint is public (no authentication required) as it's accessed from
SMS links before the user is logged in; it returns only an opaque ID, and
the detail page it resolves to stays auth-guarded.

Returns:
- **target_type**: 'call', 'chat' or 'form'
- **target_id**: The UUID of that record
- **call_id**: Deprecated; same as target_id for 'call' targets

## Path parameters

- `shortcode` string, required

## Response `200`

Successful Response

- ShortcodeResponse: Response for shortcode resolution.
  - `target_type` 'call' | 'chat' | 'form', required: What kind of record a shortcode points at.
  - `target_id` string, uuid, required: The ID of the call, chat conversation or form session
  - `call_id` string, uuid, nullable: Deprecated: same as target_id when target_type is 'call'

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-17** `0afcd7c31ce2`: 2 breaking, 2 info
  - the response property `call_id` became optional for the status `200`
  - response property `call_id` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the required property `target_id` to the response with the `200` status
  - added the required property `target_type` to the response with the `200` status

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/calls/shortcode/:shortcode/get.md)

---

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