List Requests

Retrieve a list of all requests created by your agent. This endpoint is useful for monitoring task progress and checking statuses.

Definitions

Field	Type	Required	Description
`page`	string	No	The page number to return (default: 1)
`status`	string	No	Comma-separated list of statuses to filter by (e.g., "PENDING,IN_PROGRESS")
`since`	string	No	ISO timestamp - only return tasks created/updated after this time
`limit`	string	No	Maximum number of tasks to return (default: 50, max: 100)

curl -XGET https://console.api.getmagic.com/api/v1/requests \
-H "x-api-key: <API_KEY>"

Output

{
    "requests": null,
    "count": null
}

Filtering

You can filter requests using query parameters:

By Status

Filter by one or more statuses (comma-separated):

curl -XGET "https://console.api.getmagic.com/api/v1/requests?status=PENDING,IN_PROGRESS" \
  -H "x-api-key: <API_KEY>"

Available statuses:

PENDING - Request is waiting to be picked up
IN_PROGRESS - A human assistant is working on the request
COMPLETED - Request has been fulfilled
CANCELLED - Request was cancelled

By Time

Only return requests created or updated after a specific time:

curl -XGET "https://console.api.getmagic.com/api/v1/requests?since=2025-01-01T00:00:00Z" \
  -H "x-api-key: <API_KEY>"

Pagination

Control the number of results and page through them:

limit - Maximum number of results per page (default: 50, max: 100)
page - Page number to return (default: 1, max: 10)

# Limit results to 10
curl -XGET "https://console.api.getmagic.com/api/v1/requests?limit=10" \
  -H "x-api-key: <API_KEY>"
 
# Get the second page of results
curl -XGET "https://console.api.getmagic.com/api/v1/requests?limit=10&page=2" \
  -H "x-api-key: <API_KEY>"