List API Credentials ​

Retrieve a paginated list of API credentials.

Request ​

http
GET /v1/admin/credentials
Authorization: Bearer {admin_key}

Query Parameters ​

ParameterTypeDefaultDescription
limitinteger20Results per page (1-100)
offsetinteger0Pagination offset
includeRevokedbooleanfalseInclude revoked credentials

Example Request ​

List active credentials:

bash
curl -X GET "https://api.insight.iagon.com/v1/admin/credentials?limit=10" \
  -H "Authorization: Bearer YOUR_ADMIN_KEY"

Include revoked credentials:

bash
curl -X GET "https://api.insight.iagon.com/v1/admin/credentials?includeRevoked=true" \
  -H "Authorization: Bearer YOUR_ADMIN_KEY"

Response ​

Success (200 OK) ​

json
{
  "success": true,
  "data": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "name": "Acme Production Key",
      "description": "Main production API key",
      "api_key_prefix": "iiak_a1b2c3d4",
      "created_at": "2026-01-26T12:00:00Z",
      "user_account_id": "550e8400-e29b-41d4-a716-446655440000",
      "user_account_name": "Acme Corporation",
      "user_external_id": "cust_abc123",
      "admin_key_id": "770e8400-e29b-41d4-a716-446655440002",
      "admin_entity_name": "YourCompany",
      "network_id": 0,
      "last_used_at": "2026-01-26T15:30:00Z",
      "expires_at": null,
      "revoked": false,
      "revoked_at": null,
      "rate_limit_per_minute": 120,
      "metadata": {}
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 1,
    "hasMore": false
  }
}

Get Single Credential ​

http
GET /v1/admin/credentials/:id
Authorization: Bearer {admin_key}

Example ​

bash
curl -X GET "https://api.insight.iagon.com/v1/admin/credentials/660e8400-e29b-41d4-a716-446655440001" \
  -H "Authorization: Bearer YOUR_ADMIN_KEY"

Response (200 OK) ​

json
{
  "success": true,
  "data": {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "name": "Acme Production Key",
    ...
  }
}

Error (404 Not Found) ​

json
{
  "success": false,
  "error": "Credential not found"
}

Notes ​

  • Results ordered by created_at descending (newest first)
  • Use includeRevoked=true to see revoked keys for auditing
  • The full API key is never returned - only api_key_prefix