> This page is optimized for agents. Use the linked Markdown pages and llms.txt indexes for related API content.

# Get a conversation with its messages

- Product: Reachiz API
- Section: Conversations
- Snapshot: v1
- Method: `GET`
- Path: `/v1/conversations/{id}`

## Path parameters

### `id`

Type: `number`  
Required: yes  

## Execute with curl

```bash
curl "https://prestigious-goldfish-661.convex.site/v1/conversations/$ID" \
    -H "Authorization: Bearer $REACHIZ_API_KEY"
```

## Execute with TypeScript

```ts
const response = await fetch("https://prestigious-goldfish-661.convex.site/v1/conversations/$ID", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.REACHIZ_API_KEY}`,
  },
});

const data = await response.json();
```

## Responses

### Response `200`

Category: success  

Success

#### `application/json`

##### Generated example

```json
{
  "id": 0,
  "accountId": 0,
  "type": "linkedin",
  "correspondent": {
    "name": "name",
    "publicId": "publicId",
    "headline": "headline",
    "profileUrl": "profileUrl",
    "imageUrl": "imageUrl"
  },
  "leadId": 0,
  "campaignId": 0,
  "unread": true,
  "archived": true,
  "starred": true,
  "replied": true,
  "lastMessage": {
    "preview": "preview",
    "fromMe": true,
    "at": "at"
  },
  "messages": [
    {
      "id": "id",
      "direction": "outbound",
      "body": "body",
      "subject": "subject",
      "status": "queued",
      "inmail": true,
      "sentAt": "sentAt"
    }
  ]
}
```

##### Schema

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: yes  

###### `accountId`

Type: `number`  
Required: yes  

###### `type`

Type: `string`  
Required: yes  
Allowed values: `linkedin`, `inmail`, `sales_navigator`, `recruiter`  

###### `correspondent`

Type: `object`  
Required: yes  

###### `name`

Type: `string`  
Required: yes  

###### `publicId`

Type: `string`  
Required: yes  

###### `headline`

Type: `string`  
Required: yes  

###### `profileUrl`

Type: `string`  
Required: yes  

###### `imageUrl`

Type: `string`  
Required: yes  

###### `leadId`

Type: `number`  
Required: yes  

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `campaignId`

Type: `number`  
Required: yes  

###### number

Type: `number`  

###### unknown

Type: `unknown`  

###### `unread`

Type: `boolean`  
Required: yes  

###### `archived`

Type: `boolean`  
Required: yes  

###### `starred`

Type: `boolean`  
Required: yes  

###### `replied`

Type: `boolean`  
Required: yes  

###### `lastMessage`

Type: `object`  
Required: yes  

###### `preview`

Type: `string`  
Required: yes  

###### `fromMe`

Type: `boolean`  
Required: yes  

###### `at`

Type: `string`  
Format: `date-time`  
Required: yes  

###### `messages`

Type: `object[]`  
Required: yes  

###### object

Type: `object`  

###### `id`

Type: `string`  
Required: yes  

###### `direction`

Type: `string`  
Required: yes  
Allowed values: `outbound`, `inbound`  

###### `body`

Type: `string`  
Required: yes  

###### `subject`

Type: `string`  
Required: yes  

###### `status`

Type: `string`  
Required: yes  
Allowed values: `queued`, `sent`, `failed`  

###### `inmail`

Type: `boolean`  
Required: yes  

###### `sentAt`

Type: `string`  
Format: `date-time`  
Required: yes  

### Response `400`

Category: client-error  

The request is not valid. error.fields lists each problem.

#### `application/json`

##### Generated example

```json
{
  "error": {
    "code": "invalid_request",
    "message": "message",
    "requestId": "requestId",
    "recovery": "recovery",
    "fields": [
      {
        "path": "path",
        "message": "message"
      }
    ]
  }
}
```

##### Schema

###### Error

Type: `Error`  

###### `error`

Type: `object`  
Required: yes  

###### `code`

Type: `string`  
Required: yes  
Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable`  

###### `message`

Type: `string`  
Required: yes  

###### `requestId`

Type: `string`  
Required: yes  

###### `recovery`

Type: `string`  
Required: no  

What to do next.

###### `fields`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `path`

Type: `string`  
Required: yes  

###### `message`

Type: `string`  
Required: yes  

### Response `401`

Category: client-error  

The API key is missing or not valid.

#### `application/json`

##### Generated example

```json
{
  "error": {
    "code": "invalid_request",
    "message": "message",
    "requestId": "requestId",
    "recovery": "recovery",
    "fields": [
      {
        "path": "path",
        "message": "message"
      }
    ]
  }
}
```

##### Schema

###### Error

Type: `Error`  

###### `error`

Type: `object`  
Required: yes  

###### `code`

Type: `string`  
Required: yes  
Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable`  

###### `message`

Type: `string`  
Required: yes  

###### `requestId`

Type: `string`  
Required: yes  

###### `recovery`

Type: `string`  
Required: no  

What to do next.

###### `fields`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `path`

Type: `string`  
Required: yes  

###### `message`

Type: `string`  
Required: yes  

### Response `403`

Category: client-error  

The key lacks the scope this route needs.

#### `application/json`

##### Generated example

```json
{
  "error": {
    "code": "invalid_request",
    "message": "message",
    "requestId": "requestId",
    "recovery": "recovery",
    "fields": [
      {
        "path": "path",
        "message": "message"
      }
    ]
  }
}
```

##### Schema

###### Error

Type: `Error`  

###### `error`

Type: `object`  
Required: yes  

###### `code`

Type: `string`  
Required: yes  
Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable`  

###### `message`

Type: `string`  
Required: yes  

###### `requestId`

Type: `string`  
Required: yes  

###### `recovery`

Type: `string`  
Required: no  

What to do next.

###### `fields`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `path`

Type: `string`  
Required: yes  

###### `message`

Type: `string`  
Required: yes  

### Response `404`

Category: client-error  

The resource does not exist, or belongs to another account.

#### `application/json`

##### Generated example

```json
{
  "error": {
    "code": "invalid_request",
    "message": "message",
    "requestId": "requestId",
    "recovery": "recovery",
    "fields": [
      {
        "path": "path",
        "message": "message"
      }
    ]
  }
}
```

##### Schema

###### Error

Type: `Error`  

###### `error`

Type: `object`  
Required: yes  

###### `code`

Type: `string`  
Required: yes  
Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable`  

###### `message`

Type: `string`  
Required: yes  

###### `requestId`

Type: `string`  
Required: yes  

###### `recovery`

Type: `string`  
Required: no  

What to do next.

###### `fields`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `path`

Type: `string`  
Required: yes  

###### `message`

Type: `string`  
Required: yes  

### Response `429`

Category: client-error  

Too many requests.

#### `application/json`

##### Generated example

```json
{
  "error": {
    "code": "invalid_request",
    "message": "message",
    "requestId": "requestId",
    "recovery": "recovery",
    "fields": [
      {
        "path": "path",
        "message": "message"
      }
    ]
  }
}
```

##### Schema

###### Error

Type: `Error`  

###### `error`

Type: `object`  
Required: yes  

###### `code`

Type: `string`  
Required: yes  
Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable`  

###### `message`

Type: `string`  
Required: yes  

###### `requestId`

Type: `string`  
Required: yes  

###### `recovery`

Type: `string`  
Required: no  

What to do next.

###### `fields`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `path`

Type: `string`  
Required: yes  

###### `message`

Type: `string`  
Required: yes  

### Response `503`

Category: server-error  

The service is busy. Retry with backoff.

#### `application/json`

##### Generated example

```json
{
  "error": {
    "code": "invalid_request",
    "message": "message",
    "requestId": "requestId",
    "recovery": "recovery",
    "fields": [
      {
        "path": "path",
        "message": "message"
      }
    ]
  }
}
```

##### Schema

###### Error

Type: `Error`  

###### `error`

Type: `object`  
Required: yes  

###### `code`

Type: `string`  
Required: yes  
Allowed values: `invalid_request`, `not_supported`, `unauthorized`, `subscription_required`, `forbidden`, `plan_limit_exceeded`, `workspace_suspended`, `not_found`, `conflict`, `conversation_changed`, `rate_limited`, `internal`, `unavailable`  

###### `message`

Type: `string`  
Required: yes  

###### `requestId`

Type: `string`  
Required: yes  

###### `recovery`

Type: `string`  
Required: no  

What to do next.

###### `fields`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `path`

Type: `string`  
Required: yes  

###### `message`

Type: `string`  
Required: yes  

## Related representations

- [Human documentation](/reachiz/sections/conversations/operations/get-v1-conversations-id/)
- [curl Markdown](/reachiz/sections/conversations/operations/get-v1-conversations-id.md?lang=curl)
- [TypeScript Markdown](/reachiz/sections/conversations/operations/get-v1-conversations-id.md?lang=typescript)
- [site llms.txt](/llms.txt)
- [product llms.txt](/reachiz/llms.txt)
- [snapshot llms.txt](/reachiz/llms.txt)
