# Refapp ATS partner API

For ATS vendors offering Refapp reference checking to many customers, on the dedicated endpoint Refapp sets up for each ATS. 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/ats-partner/submitcandidate.md): `POST /webhooks/{system}`
- [Read the settings to show a recruiter](/reference/ats-partner/getconfig.md): `GET /webhooks/{system}/config`
- [Read the settings to show a recruiter, with the parameters in the body](/reference/ats-partner/postconfig.md): `POST /webhooks/{system}/config`

## Webhooks

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