Search History

Paginated history of Academic Credentials searches for the authenticated tenant. Does not charge the wallet.

Request

GET/api/v1/credentials/history

{{baseUrl}}/api/v1/credentials/history

Header

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

Query Parameters

Parameter	Type	Description	Required
page	integer	Page number (default 1)	optional
per_page	integer	Items per page (1–100, default 15)	optional
status	string	Filter by search status (e.g. Complete, Pending Consent)	optional
country_id	integer	Filter by country id	optional
q	string	Search term matched against the stored query JSON	optional

Response

200 OKSample dataExample response

{
  "success": true,
  "response_code": 200,
  "message": "Search history retrieved successfully",
  "data": {
    "searches": [
      {
        "search_id": 125,
        "reference": "CRP-VC-0125",
        "status": "Complete",
        "search_type": "Transcript",
        "country": "Kenya",
        "student_name": "James Otieno Kamau",
        "institution": "University of Nairobi",
        "requested_at": "2026-08-04T18:00:00+00:00"
      }
    ],
    "pagination": {
      "current_page": 1,
      "last_page": 1,
      "per_page": 15,
      "total": 1,
      "from": 1,
      "to": 1,
      "has_more": false
    }
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

Response Fields

Field	Type	Description
success	boolean	Whether the request succeeded
response_code	number	Application response code (typically mirrors HTTP)
message	string	Human-readable status message
data	object	Payload for the verified resource
request_id	string	UUID for support and audit trails

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.