Why am I not receiving expected data from Truv’s API?

This guide helps troubleshoot missing data from Truv’s API, covering response status, request parameters, authentication, data availability, and webhook events.

If you are not getting the expected data from Truv’s API, here are possible reasons:

1. Incorrect API Request Parameters

   • Missing or incorrect products, user_id or employers in the request.
   • Ensure that all required fields are properly formatted.

2. User Authentication Issues

   • The user may have entered incorrect credentials or failed multi-factor authentication (MFA).
   • Request the user to retry login and complete any security steps.

3. Data Not Available from Payroll Provider

   • Some payroll providers do not support certain data fields.
   • If employment or income data is missing, check the provider’s limitations.

4. Order Still Processing or Failed

   • If the order is still processing, data retrieval is incomplete.
   • If the order failed, check for error messages in the response.

5. Webhooks Not Configured Properly

   • If using webhooks, verify that they are set up to receive order.completed events.
   • Ensure your webhook listener is correctly processing Truv’s responses.

6. Stale or Outdated Data

   • If data appears incomplete or outdated, initiate a data refresh request.
   • Some providers update data at fixed intervals, so waiting may be necessary.

7. API Key or Authentication Issues

   • Ensure you are using the correct API keys (Client_ID and Secret).
   • If authentication fails, Truv’s API will not return expected data.

Next Steps

• Check your API request parameters and user authentication logs.
• Review webhook configurations and order status.
• Contact Truv Support with the order ID and API response logs for further troubleshooting.