---
title: "Lookup Podium Messages"
method: POST
path: "/api/communications/podium/messages/lookup"
tags: ["communications"]
---

# Lookup Podium Messages

`POST /api/communications/podium/messages/lookup`

## Request

- Base URL: `https://api.electricair.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.electricair.io/api/communications/podium/messages/lookup`
- Auth: none declared

## Request body

- PodiumRecordSelector
  - `deal_id` integer, nullable
  - `quote_id` integer, nullable
  - `customer_id` integer, nullable
  - `lead_id` integer, nullable
  - `phone` string, nullable

## Response `200`

OK

- GetMessagesResponseModel
  - `data` Message[], required: List of messages.
    - `attachmentUrl` string, nullable: URL of message attachment. Deprecated: please refer to the attachmentUrl in the items array.
    - `body` string, nullable: Body of the message.
    - `contact` object, nullable: Deprecated: To whom the message was sent or from whom it was received.
    - `contactName` string, nullable: Name of the contact.
    - `conversation` object, required: The conversation to which the message belongs.
    - `createdAt` string, date-time, nullable: When the message was created.
    - `direction` string, nullable: Canonical locally stored message direction.
    - `failureReason` string, nullable: If the message failed to send, this will be the reason.
    - `items` MessageItem[], nullable: The individual message items (attachments, bodies, etc.).
      - `attachmentContentType` string, nullable: MIME type of the message attachment.
      - `attachmentUrl` string, nullable: Public URL of the message attachment. NOTE: There is an expiry of 7 days on this URL.
      - `body` string, nullable: Body of the message.
      - `createdAt` string, date-time, nullable: When the message item was created.
      - `deliveryStatus` string, nullable: Status of the message item.
      - `encryptedAt` string, date-time, nullable: When the item was encrypted. Null if the item is not encrypted.
      - `sendBody` string, nullable: The send body of the message item that the end consumer sees.
      - `sourceType` string, nullable: The source type of the message item.
      - `type` string, nullable: The type of the message item.
      - `uid` string, uuid, required: Podium unique identifier for message item.
      - `location` object, nullable: Location from/to which the message item was sent.
      - `sender` Sender
        - `senderUid` string, uuid, nullable: Podium unique identifier for user. Deprecated: If the message was sent from Podium then this will be the Podium user who sent it.
    - `location` object, nullable: Location from which the message was sent or to where it was sent.
    - `sender` Sender
      - `senderUid` string, uuid, nullable: Podium unique identifier for user. Deprecated: If the message was sent from Podium then this will be the Podium user who sent it.
    - `uid` string, uuid, nullable: Podium unique identifier for message.
  - `metadata` MessagesMetadata, required
    - `nextCursor` string, nullable: Cursor to get next set of items.
    - `previousCursor` string, nullable: Cursor to get previous set of items.
    - `totalItems` integer, nullable: Total number of items available.
    - `url` string, required: The resource URL.

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-09-02** `631c00db4944`: 1 info
  - added the optional property `data/items/direction` to the response with the `200` status

[Operation history](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/changes/api/communications/podium/messages/lookup/post.md)

---

[API](https://skmtc.dev/electricair/apis/electric-air-autoquote-api.md) - [All operations](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/llms.txt) - [OpenAPI document](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/revisions/a13d832a5676?raw)