HirePlus Docs

List CV generations

GET
/v1/generations

Retrieve a paginated list of CV generations. Returns generation metadata without signed download URLs (use the detail endpoint for downloads).

Authorization

ApiKeyAuth
x-api-key<token>

API key authentication. Pass your key in the x-api-key request header.

In: header

Query Parameters

page?integer

Page number (1-indexed)

limit?integer

Items per page (max 100)

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://next.hireplus.ai/api/v1/generations"
{
  "items": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "analysis_id": "6ad457ea-9426-4897-bff8-c6f3fe690582",
      "template_type": "executive",
      "region": "US",
      "target_role": "string",
      "target_industry": "string",
      "created_at": "string"
    }
  ],
  "meta": {
    "page": 0,
    "limit": 0,
    "total": 0,
    "total_pages": 0,
    "has_more": true
  }
}
{
  "error": "Invalid request parameters"
}
{
  "error": "Invalid or expired API key"
}
{
  "error": "API key does not have required scope"
}
{
  "error": "Resource not found"
}
{
  "error": "Rate limit exceeded. Max 100 requests per minute."
}
{
  "error": "Internal server error"
}

List analyses GET

Retrieve a paginated list of analyses. Supports optional status filtering. Returns analysis metadata with top-level scores.

List interview preparations GET

Retrieve a paginated list of interview preparations for the authenticated organisation. Supports page and limit query parameters.