Documentation
- Getting Started
- Authentication
- Making Requests
- Resource Creation
- Searching
- Plugins
- Webhooks
Tutorials
APIs
- Activity Codes
- Archive
- Authorization
- Bank Accounts
- Contacts
- Events
- Expenses
- Fees
- Files
- Firm
- Firm Users
- Folders
- Invoices
- Layout Designs
- Layout Matter Items
- Matter Billing Configuration
- Matter Items
- Matter Types
- Matters
- Memos
- Notifications
- Plugins
- Referral Types
- Relationships
- Roles
- Staff
- Stages
- Subscription Payments
- Subscription Promotions
- Subscriptions
- Tasks
- Users
- Webhooks
Tasks
Get tasks
Returns a list of tasks.
GET
/
tasks
curl --request GET \
--url https://api.smokeball.com/tasks \
--header 'Authorization: <api-key>' \
--header 'x-api-key: <api-key>'
{
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "GET",
"self": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "GET"
},
"value": [
{
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "GET",
"self": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"matter": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"parentTask": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"createdBy": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"completedBy": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"lastUpdatedBy": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"assignees": [
{
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
}
],
"subTasks": [
{
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
}
],
"subject": "Review contract for John Smith",
"note": "Contract needs to be reviewed and discussed with John",
"categories": [
"<string>"
],
"dueDate": "2020-02-15T00:00:00Z",
"completedDate": "2020-02-15T00:00:00Z",
"createdDate": "2020-02-15T00:00:00Z",
"isCompleted": false,
"isDeleted": false,
"lastUpdated": 637847425252027400,
"duration": "PT4H33M"
}
],
"offset": 123,
"limit": 123,
"size": 123,
"first": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"previous": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"next": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"last": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
}
}
Query Parameters
Required range:
0 <= x <= 2147483647
Required range:
1 <= x <= 500
Filter by tasks that are assigned to the specified matter id..
Example:
"1bf55840-cba3-4f8a-8c0f-66082692e493"
Filter by tasks tasks that have been completed. Leave blank if
Example:
true
Filter by tasks updated since a specified time (.net ticks representation of the UTC datetime). Cannot be used in conjunction with LastUpdated
.
Example:
637873555398585000
Filter by last updated date of a task. Cannot be used in conjunction with UpdatedSince
.
Example:
"2022-04-23T14:00:00Z"
Response
200 - application/json
When request is successful. Returns a list of 'Task' objects.
The response is of type object
.
curl --request GET \
--url https://api.smokeball.com/tasks \
--header 'Authorization: <api-key>' \
--header 'x-api-key: <api-key>'
{
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "GET",
"self": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "GET"
},
"value": [
{
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "GET",
"self": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"matter": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"parentTask": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"createdBy": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"completedBy": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"lastUpdatedBy": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"assignees": [
{
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
}
],
"subTasks": [
{
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
}
],
"subject": "Review contract for John Smith",
"note": "Contract needs to be reviewed and discussed with John",
"categories": [
"<string>"
],
"dueDate": "2020-02-15T00:00:00Z",
"completedDate": "2020-02-15T00:00:00Z",
"createdDate": "2020-02-15T00:00:00Z",
"isCompleted": false,
"isDeleted": false,
"lastUpdated": 637847425252027400,
"duration": "PT4H33M"
}
],
"offset": 123,
"limit": 123,
"size": 123,
"first": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"previous": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"next": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
},
"last": {
"id": "<string>",
"href": "<string>",
"relation": "<string>",
"method": "<string>"
}
}
Assistant
Responses are generated using AI and may contain mistakes.