The RetroTax Developer Hub

Welcome to the RetroTax developer hub. This API allows RetroTax partners to seamlessly integrate WOTC screening, in addition to geographic and state-level tax credits, into their existing software platforms so that RetroTax can handle the back-end logic to screen and process candidates. You'll find comprehensive guides and documentation to help you start working with RetroTax as quickly as possible, as well as support if you get stuck. Let's jump right in!

WOTC Overview

The Work Opportunity Tax Credit (WOTC) program is an incentive program that provides businesses with a federal income tax credit to hire individuals from targeted groups that have a particularly high unemployment rate or other special employment needs. The WOTC credit is calculated on “qualified first-year wages” and has a maximum credit of $2,400, $4,800, $5,600 or $9,600 per eligible employee, depending upon the employee’s eligible Target Group. For more detailed information, read IRS Publication 954

Intended Audience

This API documentation is intended for software developers of Human Resource Information Systems (HRIS) who aim to integrate tax credit screening into their platforms.

Integration Overview

This documentation set is geared toward full API integrations. RetroTax offers alternative integrations with varying trade-offs. For a quicker integration, we recommend the RetroTax Plugin. Please email [email protected]. A preliminary discussion can determine the best direction give your company's requirements.

Acquiring an API Key

When making a request to our API, you must use an API key in the request header. All API requests require the X-API-KEY key/value pair in the request header. This key is used to authenticate your application in AWS API Gateway for accounting and authorization purposes. If an API key is not provided, the request will fail.

To register for an API key, please email [email protected] .

If your HRIS platform manages multiple clients, we recommend using 1 API key for all accounts.

Service Entry Points

We facilitate two types of end-points in three different environments:

Production:
SNI-enabled - https://api.retrotax-aci.com
SNI-disabled - https://api-sni.retrotax-aci.com

Staging:
SNI-enabled - https://api-staging.retrotax-aci.com
SNI-disabled - https://api-sni-staging.retrotax-aci.com

QA:
SNI-enabled - https://api-qa.retrotax-aci.com
SNI-disabled - https://api-sni-qa.retrotax-aci.com