IDfier Developers
API referenceLogin

Create a login session

POST
/business/auth/request

Starts a login session, valid for 5 minutes. Build the QR code (or, on a phone, the app link) from the three values in the response; see the QR code payload guide. The session's scopes are fixed now, from your business client.

Authorization

clientIdclientSecret
headerclientid<token>
headerclientsecret<token>

Request Body

application/json
  1. body
webhookUrl?string

Optional https URL that receives the session's events

Formaturi
Lengthlength <= 500
webhookSecret?string

Required with webhookUrl; signs each event (HMAC-SHA256)

Length16 <= length <= 255

Response Body

The session

application/json
  1. response
status?Success

100 on success

data?
Example Request
curl -X POST 'https://api.idfier.com/api/v3/business/auth/request' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "status": 100,  "data": {    "referenceId": "8502eb05-558d-4480-8511-c1011710b340",    "qrReferenceSecret": "string",    "createdAt": "2019-08-24T14:15:22Z"  }}

Overview

Every Identity API endpoint, generated from its OpenAPI spec.

Get a session's status and result POST

Poll this from your server (every 2 s, backing off to 10 s) until the status is `approved`, `denied` or `error`, or `expiresAt` has passed. `user` is set once approved: always `id`, plus the fields in your scopes that IDfier has for the customer.