Authentication with Spend & Expense API token

❗️

IMPORTANT

This section is about authentication for working with the BILL Spend & Expense API. See API sandbox sign in for information about authentication for all other BILL v3 API endpoints.

You need an API token to start testing with the BILL Spend & Expense API.

Sandbox API token

The sandbox environment is a standalone environment and any testing with the API in sandbox does not affect your solution in the production environment. When your API sign up process is complete, you can test with the BILL API in the sandbox environment.

Sandbox API sign up

Simply fill in the Sandbox Access Form to set up a test company in the sandbox environment. As part of the setup, you receive a set of information for testing in the API sandbox environment.

You can then sign in to the sandbox web app with https://app-dev-sandbox.divvy.co/.

Sample Spend & Expense API request

In this cURL example, you get a list of budgets. The required header field is your apiToken.

curl --request GET \ 
--url 'https://gateway.stage.bill.com/connect/v3/spend/budgets' \
--header 'apiToken: {api_token}' \
--header 'Accept: application/json'

Production API token

Your go-live Spend & Expense solution is available to your customers in the production environment.

See How do I generate an API token in BILL Spend & Expense? in the BILL Help for instructions on getting an API token in the production environment.

❗️

IMPORTANT

In the production environment, the Spend & Expense API user must have the ADMIN user role to generate an API token.