API Documentation (Beta)

Learn how to integrate with Listee's API to programmatically manage your tasks.

Beta Status: The Listee API is currently in beta. Features and endpoints may change without prior notice during this phase.

Plan Requirements: API access is available exclusively to Plus and Pro plan subscribers. Pro plan subscribers receive access to additional endpoints and higher rate limits.

Getting Started

Authentication

All API requests require authentication using an API key:

Authorization: Bearer YOUR_API_KEY

You can obtain an API key from your Listee account settings if you are subscribed to a Plus or Pro plan.

Base URL

All API requests should be made to:

https://listee.in/api/v1

Key Endpoints

Categories

• Get all categories: GET /categories
• Create category: POST /categories
• Get category by ID: GET /categories/{categoryId}
• Update category: PUT /categories/{categoryId}
• Delete category: DELETE /categories/{categoryId}

Tasks

• Get tasks in category: GET /categories/{categoryId}/tasks
• Create task: POST /categories/{categoryId}/tasks
• Update task: PUT /categories/{categoryId}/tasks/{taskId}
• Delete task: DELETE /categories/{categoryId}/tasks/{taskId}
• Update task status: PUT /categories/{categoryId}/tasks/{taskId}/status
• Reorder tasks: PUT /categories/{categoryId}/tasks/reorder
• Delete multiple tasks: POST /categories/{categoryId}/tasks/bulk-delete
• Uncheck multiple tasks: POST /categories/{categoryId}/tasks/bulk-uncheck
• Move tasks: POST /tasks/move

Security Best Practices

• Store API keys as environment variables
• Never commit API keys to version control
• Rotate keys periodically
• Use IP restrictions in production environments

Rate Limiting

The API uses rate limiting to ensure service stability. Exceeding limits results in 429 Too Many Requests responses.

Complete Documentation

For detailed API documentation including request/response examples and error handling, please visit our API Reference.

Need help with the API? Contact our developer support team at listee@gen-ltd.jp.