# Refapp Generic ATS API

For ATS vendors offering Refapp reference checking to many customers. One partner credential authenticates the vendor; each customer is addressed by its own secret.

## Base URL

`https://{host}`

- `host` (default `test.refapp.se`): test.refapp.se while developing. In production, the host your account lives on, usually app.refapp.se.

## Authentication

`Authorization: Bearer <token>`

The partner credential Refapp issued to your ATS. It identifies the vendor; the customer comes from `X-Provider-Key` or `company.uuid`.

## Endpoints

- [Submit a candidate](/reference/generic-ats/submitcandidate.md): `POST /webhooks/ats-generic`
- [Read the settings to show a recruiter](/reference/generic-ats/getconfig.md): `GET /webhooks/ats-generic/config`
- [Read the settings to show a recruiter, with the parameters in the body](/reference/generic-ats/postconfig.md): `POST /webhooks/ats-generic/config`

## Webhooks

- [Status update pushed to your update-url](/reference/generic-ats/receivestatusupdate.md): `PUT` to your endpoint
