Developer API

Integrate MeasureYourself quizzes and results into your own applications. Our REST API provides access to quiz listings, quiz details, and result retrieval.

Getting Started

  1. Sign in to MeasureYourself
  2. Generate an API key from your profile
  3. Include the key in the X-Api-Key header
  4. Start making API calls

Rate Limits

Default: 1,000 requests per day per API key. Need more? Contact us for higher limits.

API Reference

Authentication

All API requests require an API key passed in the header:

curl -H "X-Api-Key: my_your_api_key_here" \
  https://api.mytraits.me/api/v1/quizzes

Endpoints

List Quizzes

GET /api/v1/quizzes

Response:
[
  {
    "id": "uuid",
    "slug": "big-five-ocean",
    "category": "personality",
    "title": "Big Five (OCEAN) Personality Test",
    "description": "...",
    "estimated_minutes": 10,
    "is_pro_only": false
  }
]

Get Quiz Details

GET /api/v1/quizzes/{slug}

Response:
{
  "id": "uuid",
  "slug": "big-five-ocean",
  "title": "...",
  "dimensions": [
    {"key": "openness", "label": "Openness to Experience", "description": "..."}
  ]
}

Get Result

GET /api/v1/results/{result_id}

Response:
{
  "id": "uuid",
  "quiz_title": "Big Five (OCEAN)",
  "scores": {"total": 185},
  "dimension_scores": {"openness": 72.5, "conscientiousness": 65.0, ...},
  "result_type": null,
  "taken_at": "2026-04-10T12:00:00Z"
}

Error Handling

Errors return standard HTTP status codes with a JSON body:

{
  "detail": "Error message here"
}

Status codes:
- 401: Invalid or missing API key
- 404: Resource not found
- 429: Rate limit exceeded
- 500: Server error