---
updatedAt: 2026-05-04T11:17:06.000Z
---

Fetch the complete documentation index at: https://apidocs.hibob.com/llms.txt. Use this file to discover all available pages before exploring further.

# Testing

Learn how to test endpoints using your own data

## Use the Try It! option

You can test the API directly from the "Try It!" option in the interactive API reference guide. This feature helps you understand how the API works and verifies that your parameters and permissions are set correctly.

<div class="embed">
  <iframe src="//player.vimeo.com/video/1183324414" frameborder="0" allowfullscreen="" />
</div>

Here's how to use it:

1. Go to the specific API endpoint you want to test in the documentation.
2. From the testing pane on the right, click **Try It!** .
3. Click **Base URL** to select whether to test with **Production** server or with the **Sandbox** server.
   > **Note**: The Sandbox capability is available only for accounts that have purchased Sandbox. To learn more, see <a href="https://www.hibob.com/features/#sandbox" target="_blank">HiBob's HRIS features</a>).
4. From the **Basic** authorization, enter your service user's credentials:

* Enter the service user's ID in the **username** field.
* Enter the corresponding token in the **password** field.
  > Don't have a service user yet? Check the [API Service Users](/docs/api-service-users)  guide

5. From **Body Params**, update path parameters or query parameters if required.
6. If the request includes body parameters, click the **Examples** pulldown menu and select **Request Example** to copy the parameters from the endpoint’s description into the HTTP request.
7. Click **Try It!** to execute the API call.
8. Check the **Responses** section to see the results of your API request, including the status code, headers, and any returned data.

## Error handling

To learn how to handle errors from the Bob API, see [Error handling](https://apidocs.hibob.com/reference/error-handling).

<Callout icon="🚧" theme="warn">
  Note: If you receive an **empty response** it likely means the permissions do not allow you to access the data you are trying to fetch. You should check your [permissions settings](/docs/api-service-users#step-3-set-permissions-to-the-permissions-group) , amend the permissions, and try again.
</Callout>

## Track API audit log

**<a href="https://help.hibob.com/hc/en-us/articles/29769092491665" target="_blank">View API audit logs ↗</a>**: access Public API usage details in Bob to gain greater control and understanding of how data is being accessed via the Public API.