# Sinch API Fax List

> List faxes (sent/received) via Sinch Fax API

- Skill: `sinch/sinch-api-fax-list` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sinch/sinch-api-fax-list`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sinch/sinch-api-fax-list/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: sinch (https://skillmd.com/u/sinch)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/sinch/sinch-api-fax-list

---


# List Faxes

List faxes for your project using the Sinch Fax API. Supports pagination. Uses OAuth2.

**IMPORTANT: Execute this command directly. Do NOT generate script files. Perform the API call immediately.**

## Input

- `--format` / `-f`: Output format (table or json) - optional, default table
- `--page-size` / `-n`: Number of results - optional

Arguments: $ARGUMENTS

## Instructions

**Execute these steps directly - do not write code or scripts:**

0. If $ARGUMENTS empty: use defaults (table format). Otherwise parse.

1. Get CONVERSATION_* or FAX_* env vars. GET https://fax.api.sinch.com/v3/projects/{projectId}/faxes with OAuth2. If missing, report "Sinch API is not configured."

2. Format response: table (id, to, status, createdAt, etc.) or JSON. Display "✅ Faxes listed" with count.

3. Handle 401, 404. Handle all errors gracefully.

## Examples

```
/sinch-api-fax-list
/sinch-api-fax-list --format=json
```

## API Reference

- **Endpoint**: GET /v3/projects/{projectId}/faxes
- **Documentation**: https://developers.sinch.com/docs/fax/