/individual
, /employment
, /pay-statement
). This means that several IDs can be sent in a single request. Finch will correspondingly return a single response with an array of objects equal to the IDs sent.
Determine your optimal batch size for your use case when making batch requests to Finch APIs. If you send 1000 IDs in the request, you will receive a single response containing an array of 1000 responses for each ID sent. Pass all the required IDs in a single batch request to optimize API usage and minimize the risk of hitting rate limits.
Batch Errors
When calling the Finch “batch” API endpoints, ensure your application can handle errors returned in the batch format. Finch can return errors in two ways. Both errors will be the same format described in the Error Types API Reference guide.- A possible error per batch request item within the response body.
- A possible error at the HTTP status code level.
Checkpoint + Next Step
After completing this step, you should be able to efficiently send thousands of IDs in a single HTTP request and managing each individual batched message in the main response body. Batch errors are just one type of error that can be experienced. Next, we will learn how to mitigate other error types that may be experience when calling the Finch APIs.