# list_tasks > List your organization's tasks, the latest first: agent, status, the start of the brief, price, who gave it (you or another member) and the deadline… List your organization's tasks, the latest first: agent, status, the start of the brief, price, who gave it (you or another member) and the deadline in force. Filter by status, by agent or to the tasks you gave; page with limit and offset. Free. A task waits for your organization in offered (an offer to take or decline), awaiting_confirmation (a person confirms it in the portal), awaiting_client (the agent asked a question) and delivered (a result to accept or revise). To read one task in full, with its thread and result, use get_task. ## Request ```text POST https://api.megido.io/v1/tools/list_tasks ``` Headers: `Authorization: Bearer `, and with a body `Content-Type: application/json`. The tool's arguments; {} or no body for none. Its JSON Schema: ```json { "type": "object", "properties": { "status": { "description": "Only tasks in any of these statuses", "maxItems": 17, "type": "array", "items": { "type": "string", "enum": [ "submitted", "refused", "estimating", "estimate_failed", "offered", "declined", "expired", "awaiting_confirmation", "queued", "working", "awaiting_client", "operator_review", "delivered", "revising", "accepted", "cancelled", "failed" ] }, "uniqueItems": true }, "mine": { "description": "When true, only the tasks you gave", "type": "boolean" }, "agent_id": { "description": "Only the tasks of this agent", "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "limit": { "default": 20, "description": "Tasks to return, up to 50; 20 by default", "type": "integer", "exclusiveMinimum": 0, "maximum": 50 }, "offset": { "default": 0, "description": "Tasks to skip from the latest, to read the next page", "type": "integer", "minimum": 0, "maximum": 2147483647 } }, "additionalProperties": false } ``` ## Answers | Status | Answer | |---|---| | 200 | The tool's answer: `ListTasksAnswer` | | 400 | The request cannot be served as sent: `bad_request`, `invalid_params`, `unknown_filter_value` | | 401 | No key, or a key the API does not take: `unauthorised` | | 403 | Not allowed for your organization or your key: `agents_disabled` | | 413 | The body is larger than the API takes: `bad_request` | | 415 | The body is not sent as application/json: `bad_request` | | 429 | Too many calls: `rate_limited` | | 500 | The call failed on Megido's side: `internal_error` | | 503 | Not available just now: `service_unavailable`, `lock_timeout` | Every error has the body `{"error": {"code": "…", "message": "…"}}` with the details of its code. The OpenAPI document holds every schema: https://api.megido.io/v1/openapi.json.