faxrocks.com | Make Fax Fun again            [  FR Icon              faxrocks.com ](https://faxrocks.com)  [Home

 ](https://faxrocks.com#top) [Features

 ](https://faxrocks.com#features) [Pricing

 ](https://faxrocks.com#pricing) [Blog

 ](https://faxrocks.com/blog)

      EN

    Deutsch

     English   [ Sign in ](https://faxrocks.com/sign_in) [ Get Started ](https://faxrocks.com/sign_in)

       [  FR Icon              faxrocks.com

 ](https://faxrocks.com)  [Home

 ](https://faxrocks.com#top) [Features

 ](https://faxrocks.com#features) [Pricing

 ](https://faxrocks.com#pricing)

  [

Sign in

 ](https://faxrocks.com/sign_in)     EN

    Deutsch

     English

 API Documentation

 Integrate faxrocks.com into your application using our REST API.

Authentication

All API requests require authentication using a Bearer token. Include your API token in the Authorization header.

 `Authorization: Bearer your-api-token`

Base URL

 `https://faxrocks.com/api`

Endpoints

 POST

 `/send`

Send a fax to one or multiple recipients.

Request Body

 ```
// Single recipient
{
  "number": "+49123456789",
  "data": "base64-encoded-pdf-content"
}

// Multiple recipients (max 10)
{
  "numbers": ["+49123456789", "+49987654321"],
  "data": "base64-encoded-pdf-content"
}
```

    Parameter Type Required Description     `number` string  Conditional

 Single fax number in international format. Required if numbers is not provided.   `numbers` array  Conditional

 Array of fax numbers (max 10). Required if number is not provided.   `data` string  Yes

 Base64-encoded PDF file content   `scheduled_at` string  No

 ISO 8601 date/time to schedule the fax for later delivery   `timezone` string  No

 Timezone for scheduled\_at (e.g., Europe/Berlin). Defaults to user timezone.

Response (single)  201

 ```
{
  "message": "Fax queued for transfer.",
  "number": "+49123456789",
  "pages": 2,
  "estimated_costs": 0.18
}
```

Response (batch)  201

 ```
{
  "message": "Faxes queued for transfer.",
  "faxes": [
    { "number": "+49123456789", "pages": 2, "estimated_costs": 0.18 },
    { "number": "+49987654321", "pages": 2, "estimated_costs": 0.18 }
  ]
}
```

 GET

 `/faxes`

Get a paginated list of all your faxes.

Query Parameters

    Parameter Type Default Description     `perPage` integer 15 Number of results per page (1-1000)

Response  200

 ```
{
  "data": [
    {
      "id": "656081f85ab27167270",
      "number": "+49123456789",
      "sent_at": 1705849200,
      "sent_at_timezone": "Europe/Berlin",
      "status": true,
      "error": null,
      "price": "0.09",
      "pages": 1,
      "pages_sent": 1,
      "created_at": "2024-01-21T15:00:00.000000Z",
      "updated_at": "2024-01-21T15:01:00.000000Z"
    }
  ],
  "links": { ... },
  "meta": { ... }
}
```

The id field is an alphanumeric string (lowercase letters and numbers).

 GET

 `/user`

Get the authenticated user information.

Response  200

 ```
{
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com",
  "created_at": "2024-01-01T00:00:00.000000Z",
  ...
}
```

 GET

 `/faxes/{id}/fax`

Download the original fax PDF file.

    Parameter Type Description     `id` string The fax ID (alphanumeric string)

 GET

 `/faxes/{id}/receipt`

Download the fax receipt PDF.

    Parameter Type Description     `id` string The fax ID (alphanumeric string)

MCP (Model Context Protocol)

Connect your AI tools (Claude, Cursor, etc.) directly to faxrocks.com using the Model Context Protocol. Your AI assistant can check pricing, view fax status, and send faxes on your behalf.

Endpoint

 `https://faxrocks.com/mcp/fax`

Authenticate with your API token as a Bearer token. Use the same token you use for the REST API.

Available Tools

 get-balance-tool

Get your account balance and profile information.

 get-pricing-tool

Get current per-page pricing for all destinations.

 list-faxes-tool

List your faxes with status, paginated.

 get-fax-status-tool

Get detailed status of a specific fax by ID.

 send-fax-tool

Send a fax with a base64-encoded PDF.

Setup

Add this to your MCP client configuration:

 ```
{
  "mcpServers": {
    "faxrocks": {
      "url": "https://faxrocks.com/mcp/fax",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}
```

Error Responses

    Code Meaning      401

 Unauthorized - Invalid or missing API token    403

 Forbidden - You do not have access to this resource    404

 Not Found - The requested resource does not exist    422

 Unprocessable Entity - Validation error    500

 Internal Server Error - Something went wrong on our end

   [ API Documentation ](https://faxrocks.com/api-docs) [ Status ](https://status.faxrocks.com)

© 2026 faxrocks.com. All rights reserved.