---
title: "GET /public/v1/approvals/messages"
method: GET
path: "/public/v1/approvals/messages"
tags: ["Inbox"]
---

# GET /public/v1/approvals/messages

`GET /public/v1/approvals/messages`

## Request

- Base URL: `https://api.joinvalley.co`
- URL: `https://api.joinvalley.co/public/v1/approvals/messages`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/joinvalley/apis/valley-public-api/docs/public/v1/approvals/messages/get.ts> (a function with typed inputs; its response is checked against the schema)

List outreach messages by approval status. Workspace admins and owners see messages from all campaigns in the workspace. Workspace members see only their own campaigns.

## Query parameters

- `view` 'pending' | 'approved' | 'scheduled'
- `limit` number
- `offset` number
- `search` string
- `workspaceId` string
- `campaignIds` string
- `tagIds` string
- `types` string
- `from` string
- `to` string
- `sort` 'newest' | 'oldest'
- `prospectInterestLevel` string
- `icpFit` string
- `ownerId` string

## Response `200`

Default Response

- object
  - `statusCode` number
  - `status` boolean
  - `message` string
  - `data` object
    - `messages` object[]
      - `id` string
      - `message` string, nullable
      - `status` string
      - `type` string
      - `subject` string, nullable
      - `created_at` string
      - `sent_at` string, nullable
      - `approved_at` string, nullable
      - `approved_by` string, nullable
      - `is_read` boolean
      - `rating` number, nullable
      - `campaign_id` string
      - `campaign_name` string
      - `campaign_type` string
      - `prospect_id` string
      - `prospect_first_name` string, nullable
      - `prospect_last_name` string, nullable
      - `prospect_linkedin_id` string, nullable
      - `prospect_title` string, nullable
      - `prospect_company` string, nullable
      - `prospect_profile_picture` string, nullable
      - `prospect_interest_level` string, nullable
      - `prospect_icp_fit` string, nullable
      - `prospect_status` string
    - `pagination` object
      - `limit` number
      - `offset` number
      - `total` number
      - `hasMore` boolean

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `429`: Default Response
- `500`: Default Response

---

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