API response format

All BILL API responses follow a set of rules.

Sample response: Sign in to your sandbox developer account

When you sign in with the Login API, your API session is created in response and a sessionId is generated. Use the sessionId value in all subsequent calls to confirm that you are in a signed in session.

   "response_status" : 0,
   "response_message" : "Success",
   "response_data" : {
      "sessionId" : "{session_id}",
      "orgId" : "{organization_id}",
      "apiEndPoint" : "https://api-sandbox.bill.com/api/v2",
      "usersId" : "{user_ID}"

Response format details

response_status0: Success
1: Error
response_dataresponse_data provides details for an operation-specific response if the request is successful.

For invalid or incomplete requests, response_data provides an error code and error message. See Common API error codes for more information.



createdTime and updatedTime in API responses are in the ISO 8601 format with time offset from UTC. The format is YYYY-MM-DDThh:mm:ss.sss±hhmm.

For example, 2022-06-30T07:00:00.000+0000 is 12 AM Pacific Time (7 AM UTC) on June 30, 2022. If your API testing tool does not support URL encoding, replace ± with %2B.