BILL Invoices API
The Invoices API from BILL — 3 operation(s) for invoices.
The Invoices API from BILL — 3 operation(s) for invoices.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/bill-invoices-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
title: BILL v3 Authentication Invoices API
description: 'REST API providing access to BILL''s Accounts Payable, Accounts Receivable,
and Spend & Expense capabilities — bills, invoices, vendors, customers,
payments, funding accounts, organizations, webhooks, and authentication
workflows.
Best-effort OpenAPI reconstruction from BILL''s public developer portal at
https://developer.bill.com/docs/home. Authoritative reference and Postman
collection live under https://developer.bill.com/reference and
https://developer.bill.com/llms.txt.
'
version: 3.0.0
contact:
name: BILL Developer Portal
url: https://developer.bill.com/docs/home
license:
name: Proprietary
servers:
- url: https://gateway.prod.bill.com/connect/v3
description: BILL production gateway (Connect v3)
- url: https://gateway.stage.bill.com/connect/v3
description: BILL sandbox gateway (Connect v3)
- url: https://api.bill.com/v3
description: BILL production API
- url: https://api-sandbox.bill.com/v3
description: BILL sandbox API
security:
- sessionAuth: []
tags:
- name: Invoices
paths:
/invoices:
get:
tags:
- Invoices
summary: List invoices
operationId: listInvoices
responses:
'200':
description: Invoices.
post:
tags:
- Invoices
summary: Create an invoice
operationId: createInvoice
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/InvoiceCreate'
responses:
'201':
description: Created invoice.
/invoices/{invoiceId}:
parameters:
- name: invoiceId
in: path
required: true
schema:
type: string
get:
tags:
- Invoices
summary: Retrieve an invoice
operationId: getInvoice
responses:
'200':
description: Invoice.
patch:
tags:
- Invoices
summary: Update an invoice
operationId: updateInvoice
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/InvoiceCreate'
responses:
'200':
description: Updated invoice.
/invoices/{invoiceId}/send:
parameters:
- name: invoiceId
in: path
required: true
schema:
type: string
post:
tags:
- Invoices
summary: Send an invoice to the customer
operationId: sendInvoice
responses:
'200':
description: Sent.
components:
schemas:
InvoiceCreate:
type: object
required:
- customerId
- invoiceNumber
- invoiceDate
- dueDate
- invoiceLineItems
properties:
customerId:
type: string
invoiceNumber:
type: string
invoiceDate:
type: string
format: date
dueDate:
type: string
format: date
glPostingDate:
type: string
format: date
salesTax:
type: number
format: double
invoiceLineItems:
type: array
items:
type: object
properties:
itemId:
type: string
quantity:
type: number
amount:
type: number
format: double
price:
type: number
format: double
description:
type: string
securitySchemes:
sessionAuth:
type: apiKey
in: header
name: sessionId
description: 'Session identifier obtained from `POST /login`. Expires after 35 minutes
of inactivity. A `devKey` (developer key) is also required on requests
and is sent alongside `sessionId` in the appropriate header per BILL''s
official reference.
'