Check Status

Lightweight status poll for a credentials search. Poll until status is Complete, then GET results. Does not charge the wallet.

Request

GET/api/v1/credentials/status/{searchId}

{{baseUrl}}/api/v1/credentials/status/{searchId}

Header

Header	Type	Description
Authorization	string	`Bearer YOUR_ACCESS_TOKEN` from the OAuth client-credentials flow
Content-Type	string	application/json

Response

200 OKSample dataExample response

{
  "success": true,
  "response_code": 200,
  "message": "Search status retrieved successfully",
  "data": {
    "search_id": 125,
    "status": "Complete"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response Fields

Field	Type	Description
data.search_id	integer	Search id from POST /credentials/search
data.status	string	Complete = final catalog hit ready now; Processing = awaiting verification; Pending Consent = awaiting student consent. Fetch results when Complete.
data.message	string	Present when status is Processing — The report will be ready within 5 days.

Set {{baseUrl}} to https://api.peleza.com (production) or https://sandbox.peleza.com (sandbox). Authenticated calls need a Bearer token from POST /api/v1/oauth/token.