Initiate a lookup

POST

/v3/api/business/reseller/lookups

Initiates a third-party client lookup. Bardge validates the issuer and client, sends the client's access code to them via email, and returns a pending lookup record.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

*/*

Lookup initiated — pending verification

Body*/*

🟠400

🟠401

🟠403

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v3/api/business/reseller/lookups' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "issuer": "iss_z9y8x7w6v5u4",
    "client_id": "client_abc123"
}'

Response Example

201 - Success

{
    "object": "lookup",
    "id": "lkp_a1b2c3d4e5f6",
    "issuer": "iss_z9y8x7w6v5u4",
    "status": "pending",
    "created": 1746700000
}

Modified at 2026-05-21 13:30:24

Get issuers

Verify a lookup