To-Do List Generator API

Integrate our powerful to-do list generation capabilities directly into your applications with our easy-to-use API.

POST /api/v1/generate

Request

// Example Request
{
  "user_id": "user_12345",
  "context": "I need to prepare for my upcoming business trip to Berlin next week",
  "priority_level": "high",
  "time_available": 8,
  "categories": [
    "travel",
    "work",
    "personal"
  ]
}

Parameters

Parameter	Type	Required	Description
user_id	string	Yes	Unique identifier for the user
context	string	Yes	Description of what the to-do list should accomplish
priority_level	string	No	high/medium/low (default: medium)
time_available	integer	No	Hours available to complete tasks
categories	array	No	List of categories to include

Response

// Example Response
{
  "status": "success",
  "data": {
    "tasks": [
      {
        "id": "task_67890",
        "description": "Book flight to Berlin",
        "category": "travel",
        "priority": "high",
        "estimated_time": 30,
        "due_date": "2023-06-15"
      },
      ...
    ],
    "total_tasks": 12,
    "total_time_estimate": 7.5
  }
}

Response Codes

200 Success - List generated

400 Bad request - Missing parameters

401 Unauthorized - Invalid API key

429 Too many requests - Rate limit exceeded

API Rate Limits

Free tier: 100 requests/day
Pro tier: 5,000 requests/day

Getting Started

1. Get Your API Key

2. Make Your First Request

Use the API endpoint with your key to generate your first to-do list programmatically.

3. Integrate With Your App

Parse the response and display the generated tasks in your application's interface.

Client Libraries

JavaScript

npm install todo-gen-client

Python

pip install todo-generator

PHP

composer require todo-gen/api-client

Frequently Asked Questions

How do I authenticate API requests?

Include your API key in the Authorization header of each request: Authorization: Bearer YOUR_API_KEY

What's the rate limit for the API?

Free accounts can make 100 requests per day. Pro accounts get 5,000 requests per day with higher priority processing.

Can I customize the task format in responses?

Yes! You can specify response fields and formats using the fields parameter in your request.

How do I handle errors?

The API returns standard HTTP status codes with detailed error messages in the response body to help diagnose issues.

Is there a sandbox environment for testing?

Yes, you can use our sandbox endpoint at https://api.todogenius.com/sandbox/v1/ which doesn't count against your rate limits.