Authentication with Spend & Expense API token

❗️

Important

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

You need a Spend & Expense API token to begin testing with the BILL Spend & Expense API.

Sandbox API token for Spend & Expense

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.

🚧

Limited access to Spend & Expense webhooks

At this time, the Spend & Expense webhooks are available only in the production environment. We will provide more information when these webhooks are available in the sandbox environment.

This does not affect access to any other webhook 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 app-dev-bdc-stg.divvy.co/login.

Sample Spend & Expense API request

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

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

Production API token for Spend & Expense

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 a Spend & Expense API token in the production environment.

❗️

Only ADMIN users can generate Spend & Expense API tokens

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