---
title: "Get outgoing fax"
method: GET
path: "/accounts/{user_id}/outbox/{outbox_fax_id}"
tags: ["Outbox"]
---

# Get outgoing fax

`GET /accounts/{user_id}/outbox/{outbox_fax_id}`

## Request

- Base URL: `https://restapi.fax.plus/v3`
- URL: `https://restapi.fax.plus/v3/accounts/{user_id}/outbox/{outbox_fax_id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://accounts.fax.plus/login?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost&scope=all`
    - Token URL: `https://accounts.fax.plus/token` scopes: `all`
  - HTTP bearer

Get specific details of a fax currently scheduled for sending. (Permitted scopes: **fax:all:read**, **fax:fax:read**)

## Path parameters

- `user_id` string, required
- `outbox_fax_id` string, required

## Response `200`

Response containing a single outbox object

- Outbox: Model for the outbound fax stored in the outbox
  - `comment` OutboxComment: Comment to set for the fax job
    - `tags` string[]
    - `text` string
  - `contact_name` string
  - `designated_src` string
  - `extra_info` object
  - `file_changes` object[]
    - `at` string
    - `files` object[]
      - `file_name` string
      - `mime_type` string
      - `size` number
  - `files` string[]: Files to send
  - `id` string, required: Fax ID
  - `initiated_from` object
    - `from_id` string
    - `type` string
  - `ip` string: IP address from which the send request originated
  - `last_updated_status_time` string: Time and date when the send request status was last updated. Format: *YYYY-MM-DD HH:mm:ss*
  - `options` OutboxOptions: Additional configuration for sending a fax
    - `enhancement` boolean: Text enhancement. Set to True to optimize fax file for text.
    - `retry` RetryOptions: Fax retry settings
      - `count` integer: Number of tries to send the fax
      - `delay` integer: Delay in minutes between two retries (0-720)
    - `partially_sent_retry` boolean: Enable automatic retry for partially sent faxes. Please make sure that the remote will accept chunked submissions before using it
  - `page_count` integer: Number of fax pages
  - `retry` RetryOptions: Fax retry settings
    - `count` integer: Number of tries to send the fax
    - `delay` integer: Delay in minutes between two retries (0-720)
  - `send_time` string
  - `should_enhance` boolean
  - `src` string
  - `status` 'submitted' | 'converting' | 'scheduled_for_sending' | 'sending', required: Outbound fax status
  - `status_changes` object[]
    - `at` string, required: Date and time at which status changed. Format: *YYYY-MM-DD HH:mm:ss*
    - `status` 'submitted' | 'converting' | 'scheduled_for_sending' | 'sending', required: Outbound fax status
  - `submit_time` string: Date and time when the fax was submitted for sending
  - `to` string[]
  - `uid` string, required: User ID
  - `cover_page` OutboxCoverPage: Fax cover page
    - `name_to` string, required: TO field on the cover page
    - `name_from` string, required: FROM field on the cover page
    - `subject` string, required: SUBJECT field on the cover page
    - `flags` CoverPageFlags[]: Cover page flags
    - `message` string: MESSAGE field on the cover page
    - `include_company_logo` boolean: Use company logo on the cover page

## Other responses

- `400`: Error object in case there's a problem with given data
- `500`: Error object in case there's a server error

## Changes

- **2026-11-03** `95a35a892239`: 2 breaking
  - the `options/retry/delay` response property's max was increased from `180.00` to `720.00` for the response status `200`
  - the `retry/delay` response property's max was increased from `180.00` to `720.00` for the response status `200`

[Operation history](https://skmtc.dev/fax/apis/fax-plus-rest-api/changes/accounts/:user_id/outbox/:outbox_fax_id/get.md)

---

[API](https://skmtc.dev/fax/apis/fax-plus-rest-api.md) - [All operations](https://skmtc.dev/fax/apis/fax-plus-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fax/apis/fax-plus-rest-api/revisions/95a35a892239?raw)