欢迎使用!  中文 (简体) Language Switcher

Description

Retrieves a list of tasks.

If list_id is not specified, all tasks are retrieved, unless filter is specified.

If last_sync is provided, only tasks modified since last_sync will be returned, and each <list> element will have an attribute, current, equal to last_sync.

Authentication

This method requires authentication with read permissions.

Arguments

api_key (Required)
Your API application key. See here for more details.
list_id (Optional)
The id of the list to perform an action on.
filter (Optional)
If specified, only tasks matching the desired criteria are returned. See here for more details.
last_sync (Optional)
An ISO 8601 formatted time value. If last_sync is provided, only tasks modified since last_sync will be returned, and each <list> element will have an attribute, current, equal to last_sync. Each task deleted since last_sync will be given in a <deleted> element.

Example Response

<tasks>
  <list id="987654321" current="2006-05-07T08:13:26Z">
    <taskseries id="123456789" created="2006-05-07T10:19:54Z" modified="2006-05-07T10:19:54Z"
               name="Get Bananas" source="api" url="" location_id="">
      <tags/>
      <participants/>
      <notes/>
      <task id="987654321" due="" has_due_time="0" added="2006-05-07T10:19:54Z"
           completed="" deleted="" priority="N" postponed="0" estimate=""/>
      ...
    </taskseries>
    ...
    <deleted>
      <taskseries id="650390">
        <task id="815255" deleted="2006-05-07T14:26:47Z" />
      </taskseries>
    </deleted>
    ...
  </list>
  ...
</tasks>

Error Codes

98: Login failed / Invalid auth token
The login details or auth token passed were invalid.
100: Invalid API Key
The API key passed was not valid or has expired.
105: Service currently unavailable
The requested service is temporarily unavailable.
111: Format "xxx" not found
The requested response format was not found.
112: Method "xxx" not found
The requested method was not found.
114: Invalid SOAP envelope
The SOAP envelope sent in the request could not be parsed.
115: Invalid XML-RPC Method Call
The XML-RPC request document could not be parsed.