Remote Billing Documents API

Customer-facing invoices and statements

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /billing_documents List billing documents · List Billing Documents #
Ask an LLM
“What invoices and billing documents has Remote issued to my company?”
“Can I filter billing documents by period or payment status?”
Tell an agent
List billing documents for period {period}.
Show billing documents with status {status}.
GET /billing_documents/{billing_document_id} View a billing document · Show A Billing Document #
Ask an LLM
“How do I see the totals and details of one billing document?”
“Where can I check the status of a specific Remote invoice?”
Tell an agent
Show billing document {billing_document_id}.
Get the summary of invoice {billing_document_id}.
GET /billing_documents/{billing_document_id}/breakdown Break down a billing document by line item · Get Billing Document Breakdown #
Ask an LLM
“What exactly am I being charged for on a billing document, line by line?”
“Can I see per-employee costs that make up an invoice total?”
Tell an agent
Break down the charges on billing document {billing_document_id}.
Show the itemized cost breakdown for invoice {billing_document_id}.
GET /billing_documents/{billing_document_id}/pdf Download a billing document as PDF · Download Billing Document PDF #
Ask an LLM
“How do I get a PDF copy of a Remote invoice for my accounting team?”
“Is there a way to download a billing document as a file?”
Tell an agent
Download the PDF of billing document {billing_document_id}.
Save invoice {billing_document_id} as a PDF.

Documentation

📖
Documentation
https://developer.remote.com/reference/welcome-to-remote-api
📖
Documentation
https://developer.remote.com/docs/creating-a-company
📖
Documentation
https://developer.remote.com/docs/create-new-employment
📖
Documentation
https://developer.remote.com/docs/employment-lifecycle-stages
📖
Documentation
https://developer.remote.com/docs/employment-statuses
📖
Documentation
https://developer.remote.com/docs/quick-start-guide-2
📖
Documentation
https://developer.remote.com/docs/working-with-expenses
📖
Documentation
https://developer.remote.com/docs/working-with-incentives
📖
Documentation
https://developer.remote.com/docs/working-with-time-off
📖
Documentation
https://developer.remote.com/docs/leave-policies-summary
📖
Documentation
https://developer.remote.com/docs/working-with-timesheets
📖
Documentation
https://developer.remote.com/docs/benefits-renewal
📖
Documentation
https://developer.remote.com/docs/working-with-files
📖
Documentation
https://developer.remote.com/docs/custom-fields
📖
Documentation
https://developer.remote.com/docs/working-with-countries
📖
Documentation
https://developer.remote.com/docs/employment-cost-estimation
📖
Documentation
https://developer.remote.com/docs/authentication
📖
Documentation
https://developer.remote.com/docs/authorization-for-customers
📖
Documentation
https://developer.remote.com/docs/client-credentials-flow-for-partners
📖
Documentation
https://developer.remote.com/docs/authorization-method-oauth-assertion
📖
Documentation
https://developer.remote.com/docs/refresh-token-flow

Specifications

Schemas & Data

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/remote-com:remote-com-billing-documents-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

remote-com-billing-documents-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Remote Payroll and Billing Billing Documents API
  description: 'Inspect payroll calendars, billing documents, incentives, expenses,

    payslips, and timesheets across Remote''s EOR, Global Payroll, PEO,

    and Contractor offerings. All financial events are exposed both

    via REST and via webhooks.'
  version: '2026-05-22'
  contact:
    name: Remote API Support
    url: https://support.remote.com/
  x-logo:
    url: https://remote.com/favicon.ico
servers:
- url: https://gateway.remote.com/v1
  description: Production
- url: https://gateway.remote-sandbox.com/v1
  description: Sandbox
security:
- BearerAuth: []
tags:
- name: Billing Documents
  description: Customer-facing invoices and statements
paths:
  /billing_documents:
    get:
      summary: List Billing Documents
      operationId: listBillingDocuments
      tags:
      - Billing Documents
      parameters:
      - name: status
        in: query
        schema:
          type: string
          enum:
          - issued
          - paid
          - overdue
          - void
      - name: period
        in: query
        schema:
          type: string
          description: YYYY-MM
      responses:
        '200':
          description: Billing documents.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingDocumentList'
  /billing_documents/{billing_document_id}:
    parameters:
    - name: billing_document_id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    get:
      summary: Show A Billing Document
      operationId: showBillingDocument
      tags:
      - Billing Documents
      responses:
        '200':
          description: Billing document.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingDocumentEnvelope'
  /billing_documents/{billing_document_id}/breakdown:
    parameters:
    - name: billing_document_id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    get:
      summary: Get Billing Document Breakdown
      operationId: getBillingDocumentBreakdown
      tags:
      - Billing Documents
      responses:
        '200':
          description: Line-item breakdown.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
  /billing_documents/{billing_document_id}/pdf:
    parameters:
    - name: billing_document_id
      in: path
      required: true
      schema:
        type: string
        format: uuid
    get:
      summary: Download Billing Document PDF
      operationId: downloadBillingDocumentPdf
      tags:
      - Billing Documents
      responses:
        '200':
          description: PDF binary.
          content:
            application/pdf:
              schema:
                type: string
                format: binary
components:
  schemas:
    BillingDocumentList:
      type: object
      properties:
        data:
          type: object
          properties:
            billing_documents:
              type: array
              items:
                $ref: '#/components/schemas/BillingDocument'
    BillingDocumentEnvelope:
      type: object
      properties:
        data:
          type: object
          properties:
            billing_document:
              $ref: '#/components/schemas/BillingDocument'
    BillingDocument:
      type: object
      properties:
        id:
          type: string
          format: uuid
        number:
          type: string
        status:
          type: string
          enum:
          - issued
          - paid
          - overdue
          - void
        amount:
          type: integer
          description: Amount in smallest currency unit.
        currency:
          type: string
        issued_at:
          type: string
          format: date-time
        due_at:
          type: string
          format: date-time
        period_start:
          type: string
          format: date
        period_end:
          type: string
          format: date
        type:
          type: string
          enum:
          - eor_invoice
          - payroll_fee_invoice
          - contractor_invoice
          - reserve_invoice
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT