Return a paginated list of tasks matching the query parameters.
Retrieve a paginated list of tasks filtered and sorted by criteria as specified in the query
params for the request.
Note that specifying an offset past the end of the list will result in an HTTP 200 response,
with the offset set to the value you specified, but tasks will be an empty list.
If true, the sort order for the sort criteria is set to ascending. false or leaving this value unspecified will cause descending sort order to be used.
List of matching tasks, filtered and sorted by the criteria in the request.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Synthpop","description":"Build patient-journey automation — intake, coverage, and engagement — through one API.","colors":{"primary":"#FB009F","light":"#FF66C4","dark":"#C2007A"},"logo":{"light":"https://mintcdn.com/synthpop/iAq5a50OWADyCmkV/logo/light.png?fit=max\u0026auto=format\u0026n=iAq5a50OWADyCmkV\u0026q=85\u0026s=ea4d2c5b903dcc439031983528dcece5","dark":"https://mintcdn.com/synthpop/iAq5a50OWADyCmkV/logo/dark.png?fit=max\u0026auto=format\u0026n=iAq5a50OWADyCmkV\u0026q=85\u0026s=41a4c542813d07abb682af1a81b56a2f"},"favicon":"https://mintcdn.com/synthpop/iAq5a50OWADyCmkV/favicon.png?fit=max\u0026auto=format\u0026n=iAq5a50OWADyCmkV\u0026q=85\u0026s=6dc711fa2fc21f76d03f35f7f26d900e","navbar":{"primary":{"type":"button","label":"Request access","href":"https://www.synthpop.ai/contact-us"}},"footer":{"socials":{"website":"https://synthpop.ai/"}},"fonts":{"heading":{"family":"NaN Serf B","weight":500,"source":"fonts/NaNSerfBHeadline-Medium.woff2","format":"woff2"},"body":{"family":"Neue Haas Grotesk Display","weight":400,"source":"fonts/NHGDisplay-55Roman.woff2","format":"woff2"}},"integrations":{"ga4":{"measurementId":"G-ZN1VC2CPF0"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"synthpop","hasAudioNarration":false,"actualSubdomain":"synthpop","customDomains":["docs.synthpop.ai"],"gitSource":{"type":"github","owner":"synthpop-inc","repo":"synthpop-mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af5933d9aa4e2cefaca4833","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Documentation","count":26},{"language":"default","tag":"API reference","count":9},{"language":"default","tag":"Endpoints","count":8},{"language":"default","tag":"Tasks","count":6},{"language":"default","tag":"Patient engagement","count":5},{"language":"default","tag":"Core concepts","count":4},{"language":"default","tag":"Working with the API","count":4},{"language":"default","tag":"Resources","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Referral \u0026 order intake","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".prose a,article a{color:#C2007A}.dark .prose a,.dark article a{color:#FF66C4}"}],"page":{"pagePath":"api-reference/task-list/get-a-list-of-tasks","slug":"/api-reference/task-list/get-a-list-of-tasks","pageMetadata":{"title":"Get a list of tasks.","description":"Return a paginated list of tasks matching the query parameters.\n\nRetrieve a paginated list of tasks filtered and sorted by criteria as specified in the query\nparams for the request.\n\nNote that specifying an `offset` past the end of the list will result in an HTTP 200 response,\nwith the `offset` set to the value you specified, but `tasks` will be an empty list.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /task/list","href":"/api-reference/task-list/get-a-list-of-tasks","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Return a paginated list of tasks matching the query parameters.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Retrieve a paginated list of tasks filtered and sorted by criteria as specified in the query\\nparams for the request.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Note that specifying an \", _jsx(_components.code, {\n children: \"offset\"\n }), \" past the end of the list will result in an HTTP 200 response,\\nwith the \", _jsx(_components.code, {\n children: \"offset\"\n }), \" set to the value you specified, but \", _jsx(_components.code, {\n children: \"tasks\"\n }), \" will be an empty list.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get a list of tasks.","description":"Return a paginated list of tasks matching the query parameters.\n\nRetrieve a paginated list of tasks filtered and sorted by criteria as specified in the query\nparams for the request.\n\nNote that specifying an `offset` past the end of the list will result in an HTTP 200 response,\nwith the `offset` set to the value you specified, but `tasks` will be an empty list.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /task/list","href":"/api-reference/task-list/get-a-list-of-tasks","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Task List"],"summary":"Get a list of tasks.","description":"Return a paginated list of tasks matching the query parameters.\n\nRetrieve a paginated list of tasks filtered and sorted by criteria as specified in the query\nparams for the request.\n\nNote that specifying an `offset` past the end of the list will result in an HTTP 200 response,\nwith the `offset` set to the value you specified, but `tasks` will be an empty list.","operationId":"p_api_get_tasks_task_list_get","parameters":["f3723f09-3313-479f-acdb-ded47271df3b","e612759d-78d6-4f68-a81b-399a1343fce7","380b2a55-7ab2-48cd-a3a2-8d3d8ce884f7","6b1d40c4-b4bd-409d-b2e5-ff8fd435643e","f5a85655-3d58-4b84-a6f1-fad8fc49aea7","c2f49352-0092-4f23-9998-02f9965b77ab","6dade5be-5e34-4e30-8cd2-755624ddd6ad","5bc9f7ea-555e-4947-a3cc-effbe5ae7866","0e86f66c-d1e4-40ba-87fb-9e3315ffc6e4","61367ba0-4a90-4f5d-9751-b9f63439718e"],"responses":{"200":"4e8f4a24-5a29-4655-bf39-8496dad85cf5","422":"4b2c2a9a-d23d-4e33-9b0b-f82a70a0ccac"},"security":["24c2ec89-6d6f-4c54-b38b-68c685ec861c"],"method":"get","type":"path","servers":["b96bc96e-b431-49ab-85ac-a5c5df9ac2f0","1f841823-0105-43a3-bdbd-49e59db12d28"],"path":"/task/list","baseUrlOptions":["https://app.synthpop.ai/public/v1","https://stage.synthpop.ai/public/v1"],"title":"Get a list of tasks.","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f3723f09-3313-479f-acdb-ded47271df3b":{"name":"selected_date","in":"query","required":false,"schema":{"type":"string","enum":["created","latest_status_change","cleared"],"title":"DateFlavor","description":"Specifies on what date (task creation or latest status change) the `date_from` and `date_to` limits should operate on. Default is `created`.","default":"created","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Specifies on what date (task creation or latest status change) the `date_from` and `date_to` limits should operate on. Default is `created`."},"e612759d-78d6-4f68-a81b-399a1343fce7":{"name":"date_from","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Date From","description":"Records with date or time stamps newer than this value, if specified.","format":"date-time","uniqueKey":"oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"string","title":"Date From","description":"Records with date or time stamps newer than this value, if specified.","format":"date","uniqueKey":"oneOf.1","typeLabel":"string\u003cdate>"}],"isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time> | string\u003cdate>"},"description":"Records with date or time stamps newer than this value, if specified."},"380b2a55-7ab2-48cd-a3a2-8d3d8ce884f7":{"name":"date_to","in":"query","required":false,"schema":{"oneOf":[{"type":"string","title":"Date To","description":"Records with date or time stamps up to and including this value, if specified.","format":"date-time","uniqueKey":"oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"string","title":"Date To","description":"Records with date or time stamps up to and including this value, if specified.","format":"date","uniqueKey":"oneOf.1","typeLabel":"string\u003cdate>"}],"isRequired":false,"uniqueKey":"","typeLabel":"string\u003cdate-time> | string\u003cdate>"},"description":"Records with date or time stamps up to and including this value, if specified."},"6b1d40c4-b4bd-409d-b2e5-ff8fd435643e":{"name":"cleared","in":"query","required":false,"schema":{"type":"boolean","description":"Only return records with the `cleared` flag set/unset, if specified.","title":"Cleared","isRequired":false,"uniqueKey":"","typeLabel":"boolean"},"description":"Only return records with the `cleared` flag set/unset, if specified."},"f5a85655-3d58-4b84-a6f1-fad8fc49aea7":{"name":"status","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","enum":["pending","processing","waiting","completed","failed","invalid","deferred"],"title":"TaskStatus","description":"Current state of a task.\n\n- `pending`: The task is waiting to be processed.\n- `processing`: The task is currently being processed.\n- `waiting`: The task is waiting for additional input.\n- `completed`: The task has completed processing.\n- `failed`: An error occurred while the task was being processed.\n- `invalid`: The data uploaded does not provide any information pertaining to\n the task to be performed.\n- `deferred`: The bulk processing task has been put into a deferred state due to high load","uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Only return records matching any of the specified task status values, if specified.","default":[],"title":"Status","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>[]"},"description":"Only return records matching any of the specified task status values, if specified."},"c2f49352-0092-4f23-9998-02f9965b77ab":{"name":"order_by","in":"query","required":false,"schema":{"type":"string","enum":["created","latest_status_change","cleared","name","id","external_id"],"title":"OrderBy","description":"Sort criteria to use for the query.","default":"created","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Sort criteria to use for the query."},"6dade5be-5e34-4e30-8cd2-755624ddd6ad":{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"Start offset to use for records returned.","default":0,"title":"Offset","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Start offset to use for records returned."},"5bc9f7ea-555e-4947-a3cc-effbe5ae7866":{"name":"length","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"Max. number of matching records to return from `offset`.","default":100,"title":"Length","isRequired":false,"uniqueKey":"","typeLabel":"integer"},"description":"Max. number of matching records to return from `offset`."},"0e86f66c-d1e4-40ba-87fb-9e3315ffc6e4":{"name":"sort_ascending","in":"query","required":false,"schema":{"type":"boolean","description":"If `true`, the sort order for the sort criteria is set to ascending. `false` or leaving this value unspecified will cause descending sort order to be used.","default":false,"title":"Sort Ascending","isRequired":false,"uniqueKey":"","typeLabel":"boolean"},"description":"If `true`, the sort order for the sort criteria is set to ascending. `false` or leaving this value unspecified will cause descending sort order to be used."},"61367ba0-4a90-4f5d-9751-b9f63439718e":{"name":"task_type","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"description":"Only return records with specified task types, if specified.","default":[],"title":"Task Type","isRequired":false,"uniqueKey":"","typeLabel":"string[]"},"description":"Only return records with specified task types, if specified."}},"responses":{"4e8f4a24-5a29-4655-bf39-8496dad85cf5":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"count":{"type":"integer","title":"Count","description":"Total number of matching tasks.","isRequired":true,"uniqueKey":"count","typeLabel":"integer"},"offset":{"type":"integer","title":"Offset","description":"Start offset within the sorted list of matching records for the data returned in this response.","isRequired":true,"uniqueKey":"offset","typeLabel":"integer"},"tasks":{"items":{"properties":{"uuid":{"type":"string","format":"uuid","title":"Uuid","description":"A unique ID for the Task.","isRequired":true,"uniqueKey":"tasks.items.[INDEX].uuid","typeLabel":"string\u003cuuid>"},"task_type":{"type":"string","title":"Task Type","description":"A Task's type. Determines what kind of processing is performed on the input data.","isRequired":true,"uniqueKey":"tasks.items.[INDEX].task_type","typeLabel":"string"},"status":{"type":"string","enum":["pending","processing","waiting","completed","failed","invalid","deferred"],"title":"TaskStatus","description":"Current state of a task.\n\n- `pending`: The task is waiting to be processed.\n- `processing`: The task is currently being processed.\n- `waiting`: The task is waiting for additional input.\n- `completed`: The task has completed processing.\n- `failed`: An error occurred while the task was being processed.\n- `invalid`: The data uploaded does not provide any information pertaining to\n the task to be performed.\n- `deferred`: The bulk processing task has been put into a deferred state due to high load","isRequired":true,"uniqueKey":"tasks.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"name":{"type":"string","title":"Name","description":"A user friendly name, based on information extracted from inputs.","isRequired":true,"uniqueKey":"tasks.items.[INDEX].name","typeLabel":"string"},"cleared":{"oneOf":[{"type":"string","title":"Cleared","description":"`cleared` can be set to a timestamp indicating when follow-ups (work external to Synthpop) related to this Task have been completed. Initialized to `null` upon Task creation.","format":"date-time","isRequired":true,"uniqueKey":"tasks.items.[INDEX].cleared.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Cleared","description":"`cleared` can be set to a timestamp indicating when follow-ups (work external to Synthpop) related to this Task have been completed. Initialized to `null` upon Task creation.","isRequired":true,"uniqueKey":"tasks.items.[INDEX].cleared.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"tasks.items.[INDEX].cleared","typeLabel":"string\u003cdate-time> | null"},"created":{"type":"string","format":"date-time","title":"Created","description":"Timestamp indicating when this task was created.","isRequired":true,"uniqueKey":"tasks.items.[INDEX].created","typeLabel":"string\u003cdate-time>"},"latest_status_change":{"type":"string","format":"date-time","title":"Latest Status Change","description":"Timestamp indicating when the latest status change for this task occurred. This indicates when a Task entered `processing`, `waiting`, `completed` or `failed` state. For `pending` tasks this is set to the same value as `created`.","isRequired":true,"uniqueKey":"tasks.items.[INDEX].latest_status_change","typeLabel":"string\u003cdate-time>"},"external_id":{"oneOf":[{"type":"string","title":"External Id","description":"An optional third party assigned ID for the task.","maxLength":1024,"uniqueKey":"tasks.items.[INDEX].external_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"External Id","description":"An optional third party assigned ID for the task.","uniqueKey":"tasks.items.[INDEX].external_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"tasks.items.[INDEX].external_id","typeLabel":"string | null"}},"type":"object","required":["uuid","task_type","status","name","cleared","created","latest_status_change"],"title":"TaskSummary","description":"A task's metadata summary.","uniqueKey":"tasks.items.[INDEX]","typeLabel":"TaskSummary · object"},"type":"array","title":"Tasks","description":"List of matching tasks, filtered and sorted by the criteria in the request.","isRequired":true,"uniqueKey":"tasks","typeLabel":"TaskSummary · object[]"}},"type":"object","required":["count","offset","tasks"],"title":"GetTasksResponse","description":"Response from getting a list of tasks.","uniqueKey":"","typeLabel":"GetTasksResponse · object"},"examples":{"Example":{"title":"Example","value":{"count":123,"offset":123,"tasks":[{"uuid":"3c90c3cc-0d44-4b50-8888-8dd25736052a","task_type":"\u003cstring>","status":"pending","name":"\u003cstring>","cleared":"2023-11-07T05:31:56Z","created":"2023-11-07T05:31:56Z","latest_status_change":"2023-11-07T05:31:56Z","external_id":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"4b2c2a9a-d23d-4e33-9b0b-f82a70a0ccac":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"24c2ec89-6d6f-4c54-b38b-68c685ec861c":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"}}},"servers":{"b96bc96e-b431-49ab-85ac-a5c5df9ac2f0":{"url":"https://app.synthpop.ai/public/v1","description":"Production"},"1f841823-0105-43a3-bdbd-49e59db12d28":{"url":"https://stage.synthpop.ai/public/v1","description":"Staging"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"Bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"Bearer","name":"Authorization"}],"title":"Bearer"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"synthpop","siteName":"Synthpop","title":"Get a list of tasks. - Synthpop","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-12T10:22:01.372Z","originalFileLocation":"api-reference/task-list/get-a-list-of-tasks.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Return a paginated list of tasks matching the query parameters. Retrieve a paginated list of tasks filtered and sorted by criteria as specified in the query params for the request. Note that specifying an offset past the end of the list will result in an HTTP 200 response, with the offset set to the value you specified, but tasks will be an empty list.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Synthpop\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a list of tasks. - Synthpop\">\u003cmeta data-mint-head property=\"og:description\" content=\"Return a paginated list of tasks matching the query parameters. Retrieve a paginated list of tasks filtered and sorted by criteria as specified in the query params for the request. Note that specifying an offset past the end of the list will result in an HTTP 200 response, with the offset set to the value you specified, but tasks will be an empty list.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Synthpop\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://synthpop.mintlify.site/_mintlify/api/og/v2?division=Task+List\u0026amp;title=Get+a+list+of+tasks.\u0026amp;description=Return+a+paginated+list+of+tasks+matching+the+query+parameters.%0A%0ARetrieve+a+paginated+list+of+tasks+filtered+and+sorted+by+criteria+as+specified+in+the+query%0Apa\u0026amp;theme=4ef178fb47054605cc561714\u0026amp;signature=78f10c002bec9889e48db6455bde8b8481aff53df3a26ca4a8f8334d2e15b2ee\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a list of tasks. - Synthpop\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Return a paginated list of tasks matching the query parameters. Retrieve a paginated list of tasks filtered and sorted by criteria as specified in the query params for the request. Note that specifying an offset past the end of the list will result in an HTTP 200 response, with the offset set to the value you specified, but tasks will be an empty list.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://synthpop.mintlify.site/_mintlify/api/og/v2?division=Task+List\u0026amp;title=Get+a+list+of+tasks.\u0026amp;description=Return+a+paginated+list+of+tasks+matching+the+query+parameters.%0A%0ARetrieve+a+paginated+list+of+tasks+filtered+and+sorted+by+criteria+as+specified+in+the+query%0Apa\u0026amp;theme=4ef178fb47054605cc561714\u0026amp;signature=78f10c002bec9889e48db6455bde8b8481aff53df3a26ca4a8f8334d2e15b2ee\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/synthpop/7HtEvRHbJtHfWbPH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Synthpop\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FB009F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/task-list/get-a-list-of-tasks.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.synthpop.ai/#organization\",\"name\":\"Synthpop\",\"url\":\"https://docs.synthpop.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/synthpop/iAq5a50OWADyCmkV/logo/light.png?fit=max\u0026auto=format\u0026n=iAq5a50OWADyCmkV\u0026q=85\u0026s=ea4d2c5b903dcc439031983528dcece5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.synthpop.ai#website\",\"name\":\"Synthpop\",\"url\":\"https://docs.synthpop.ai\",\"publisher\":{\"@id\":\"https://docs.synthpop.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks#webpage\",\"url\":\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks\",\"name\":\"Get a list of tasks.\",\"description\":\"Return a paginated list of tasks matching the query parameters. Retrieve a paginated list of tasks filtered and sorted by criteria as specified in the query params for the request. Note that specifying an offset past the end of the list will result in an HTTP 200 response, with the offset set to the value you specified, but tasks will be an empty list.\",\"dateModified\":\"2026-11-12T10:22:01.372Z\",\"isPartOf\":{\"@id\":\"https://docs.synthpop.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.synthpop.ai/api-reference/authentication/exchange-an-api-secret-for-a-token\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a list of tasks.\",\"item\":\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks#apireference\",\"headline\":\"Get a list of tasks.\",\"name\":\"Get a list of tasks.\",\"description\":\"Return a paginated list of tasks matching the query parameters. Retrieve a paginated list of tasks filtered and sorted by criteria as specified in the query params for the request. Note that specifying an offset past the end of the list will result in an HTTP 200 response, with the offset set to the value you specified, but tasks will be an empty list.\",\"url\":\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks\",\"mainEntityOfPage\":{\"@id\":\"https://docs.synthpop.ai/api-reference/task-list/get-a-list-of-tasks#webpage\"},\"dateModified\":\"2026-11-12T10:22:01.372Z\",\"publisher\":{\"@id\":\"https://docs.synthpop.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.synthpop.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Synthpop\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Synthpop\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/task-list/get-a-list-of-tasks.md","siteName":"Synthpop","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"Authentication","pages":[{"title":"Exchange an API secret for a token","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /auth/get_token","href":"/api-reference/authentication/exchange-an-api-secret-for-a-token"}]},{"group":"Tasks","pages":[{"title":"Create a New Task.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /task/create","href":"/api-reference/tasks/create-a-new-task"},{"title":"Retrieve a Task.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /task/get","href":"/api-reference/tasks/retrieve-a-task"},{"title":"Update Task Metadata.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /task/{uuid}/update","href":"/api-reference/tasks/update-task-metadata"},{"title":"Upload additional data.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /task/{uuid}/upload","href":"/api-reference/tasks/upload-additional-data"},{"title":"Get File Download Link.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /task/{task_uuid}/data_item/{data_item_uuid}/get_link","href":"/api-reference/tasks/get-file-download-link"},{"title":"Add an event to the task's event log.","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /task/{task_uuid}/log_event","href":"/api-reference/tasks/add-an-event-to-the-tasks-event-log"}]},{"group":"Task List","pages":[{"title":"Get a list of tasks.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /task/list","href":"/api-reference/task-list/get-a-list-of-tasks"}]}]}]}]},"basePath":"","title":"Get a list of tasks. - Synthpop","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}