sinch-api-fax-list

List sent and received faxes via the Sinch Fax API with pagination.

6|2|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-fax-list-sinch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sinch-api-fax-list
Source: https://github.com/sinch/sinch-plugins/tree/main/plugins/sinch-antigravity-plugin/skills/sinch-api-fax-list
Command: npx skills add https://github.com/sinch/sinch-plugins --skill sinch-api-fax-list-sinch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Retrieving fax history from the Sinch Fax API normally requires writing HTTP requests with OAuth2 authentication and handling pagination manually. This Skill performs the API call directly and formats the results for immediate review. ## Core Features & Use Cases - Fax Listing: Retrieve sent and received faxes for your Sinch project via GET /v3/projects/{projectId}/faxes. - Flexible Output: Display results as a readable table (id, to, status, createdAt) or as raw JSON. - Pagination Support: Control the number of results returned with a page-size option. - Use Case: A support engineer needs to verify whether a customer's fax was delivered; they run the list command and inspect the status column for the relevant recipient. ## Quick Start Ask the assistant to list recent faxes from your Sinch account, optionally requesting JSON output or a specific page size.

Frequently Asked Questions about sinch-api-fax-list

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list faxes with the Sinch Fax API?

Send a GET request to https://fax.api.sinch.com/v3/projects/{projectId}/faxes authenticated with OAuth2. This Skill performs that call directly and formats the response as a table or JSON without writing any script files.

How to check fax delivery status in Sinch?

List your project's faxes and inspect the status field of each entry, which shows whether a fax was sent, received, or failed. The table output includes id, recipient, status, and creation timestamp for quick scanning.

What credentials does the Sinch Fax API require?

The API uses OAuth2 and expects CONVERSATION_* or FAX_* environment variables containing your project credentials. If these are missing, the Skill reports that the Sinch API is not configured.

Does the Sinch fax list endpoint support pagination?

Yes, the endpoint supports pagination and this Skill exposes a page-size option to control how many results are returned per request. Use it when your project has a large fax history.

Why do I get a 401 error when listing Sinch faxes?

A 401 response indicates invalid or missing OAuth2 credentials. Verify that your environment variables contain a valid project ID, key ID, and key secret from the Sinch dashboard.