Retrieve user

GET /api/users/<customer_identifier>/

Python

import requests

url = "https://api.keywordsai.co/api/users/user_123/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.get(url, headers=headers)
print(resp.json())

{
  "id": 12345,
  "customer_identifier": "user_123",
  "unique_organization_id": "8264a3f4-40c7-476a-97d1-96908127ea21",
  "email": "[e-mail]",
  "name": "John Doe",
  "environment": "prod",
  "organization": 456,
  "period_budget": 100.0,
  "budget_duration": "monthly",
  "total_period_usage": 45.67,
  "period_start": "2025-12-01T00:00:00Z",
  "period_end": null,
  "total_budget": null,
  "total_usage": 523.45,
  "total_requests": 15420,
  "total_prompt_tokens": 125000,
  "total_completion_tokens": 45000,
  "total_tokens": 170000,
  "total_cache_hits": 234,
  "average_latency": 1.23,
  "average_ttft": 0.45,
  "average_monthly_cost": 67.89,
  "top_models": {},
  "last_active": "2025-12-29T10:30:00Z",
  "created_at": "2025-10-15T08:00:00Z",
  "updated_at": "2025-12-29T10:30:00Z",
  "metadata": null,
  "markup_percentage": 0.0,
  "is_test": false,
  "blurred": null,
  "organization_key": null
}

Retrieves detailed information about a specific customer, including current budget usage.

Authentication

Public API: use an API key.

• Authorization: Bearer YOUR_API_KEY (public API)

Path params

customer_identifier · string · required

Your unique identifier for this customer.

Query params

You can add these params to the URL params.

environment · string · default: "prod"

Specify environment if you are not using the default. Options: prod, test.

Request example

Python

import requests

url = "https://api.keywordsai.co/api/users/user_123/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

resp = requests.get(url, headers=headers)
print(resp.json())

Response

{
  "id": 12345,
  "customer_identifier": "user_123",
  "unique_organization_id": "8264a3f4-40c7-476a-97d1-96908127ea21",
  "email": "[e-mail]",
  "name": "John Doe",
  "environment": "prod",
  "organization": 456,
  "period_budget": 100.0,
  "budget_duration": "monthly",
  "total_period_usage": 45.67,
  "period_start": "2025-12-01T00:00:00Z",
  "period_end": null,
  "total_budget": null,
  "total_usage": 523.45,
  "total_requests": 15420,
  "total_prompt_tokens": 125000,
  "total_completion_tokens": 45000,
  "total_tokens": 170000,
  "total_cache_hits": 234,
  "average_latency": 1.23,
  "average_ttft": 0.45,
  "average_monthly_cost": 67.89,
  "top_models": {},
  "last_active": "2025-12-29T10:30:00Z",
  "created_at": "2025-10-15T08:00:00Z",
  "updated_at": "2025-12-29T10:30:00Z",
  "metadata": null,
  "markup_percentage": 0.0,
  "is_test": false,
  "blurred": null,
  "organization_key": null
}