# Search Tasks by Name, Details, Assignee and Due Date

> Find Tasks by name or details, then narrow them to an Event, an Assignee, a Due Date range or what's still Incomplete.

This is the Markdown copy of https://api.exhibitday.com/Help/V1?guide=search-tasks for AI tools. Code examples are in curl, JavaScript, Python and C#; the help page shows all 8 languages, and https://api.exhibitday.com/llms-full.txt has the complete reference in one file. Index of all pages: https://api.exhibitday.com/llms.txt

Find Tasks by name or details, then narrow them to an Event, an Assignee, a Due Date range or what's still Incomplete.

Example use case

A few weeks before a show, you want every Incomplete Task about the booth, the Tasks whose Details mention the hotel block, and everything still on your coordinator's list.

What you'll end up with

The Tasks that match your search, with their IDs, Events, Due Dates and Assignees.

Before you start

Have a workspace API key. To narrow the search, have an Event ID or the ID of the person assigned the Tasks.

Good to know

A Task must match every filter you send. Tasks come back in Task Board order unless you choose a sort.

## At a glance

Time to try

About 10 minutes

Effect on your data

Read-only

Endpoints

1

The requests only read Tasks. They change nothing.

- [`GET /v1/tasks`](https://api.exhibitday.com/Help/V1?epf=2#get-v1-tasks)

## How it works

1. Search Task names, or the text in each Task's Details.
2. Narrow the list to an Event, an Assignee, a Due Date range or what's still Incomplete.
3. Combine filters and read every page.

## How search matching works

- Searches ignore letter case, accents and spaces before or after your text. `cafe`, `Café` and `CAFE` find the same Tasks.
- `%`, `_` and `[` match themselves. Search for them like any other character.
- A blank name or Details search is ignored, so it doesn't narrow the list.
- Name and Details searches find your text anywhere in the saved text.
- Details are saved as formatted text (HTML). The search turns common codes, such as curly apostrophes, ampersands (&), non-breaking spaces and line breaks, into plain characters, so the words you type match. A word with formatting inside it, such as one bold letter, may still not match.

## Search your Tasks

## Step 1: Search by part of the Task name

Find Incomplete Tasks with `booth` anywhere in the name. The later steps add `$return_task_lites=true` to keep each result short.

```bash
curl -X GET "https://api.exhibitday.com/v1/tasks?filter_by_task_name_contains_text=booth&filter_by_incomplete_only=true&%24limit=50&%24offset=0" -H "Authorization: Bearer YOUR_API_KEY"
```

**Example response (shortened)**

```json
{
  "records_found": 1,
  "total_records": 1,
  "has_more": false,
  "list_data": [
    {
      "id": 12345,
      "name": "Sample task",
      "due_date": null,
      "is_completed": false
    }
  ]
}
```

**Check:** Leave out `filter_by_incomplete_only` to include Completed Tasks too. Each result's `event` tells you which show it belongs to.

## Step 2: Search the Details

Find Tasks whose Details mention `hotel block`. Send `filter_by_task_details_contains_text` with plain words, the way you'd type them on the website.

```bash
curl -X GET "https://api.exhibitday.com/v1/tasks?filter_by_task_details_contains_text=hotel%20block&%24return_task_lites=true&%24limit=50&%24offset=0" -H "Authorization: Bearer YOUR_API_KEY"
```

**Check:** Task Lite results leave out the Details. Leave out `$return_task_lites` to read `details`, which comes back as the saved formatted text (HTML).

## Step 3: Find an Assignee's Incomplete Tasks for one Event

Send the Event ID and the Assignee's user ID. This finds the Incomplete Tasks for Event `12345` assigned to that person.

```bash
curl -X GET "https://api.exhibitday.com/v1/tasks?filter_by_event_id=12345&filter_by_assignee_user_id=11111111-2222-4333-8444-555555555555&filter_by_incomplete_only=true&%24return_task_lites=true&%24limit=50&%24offset=0" -H "Authorization: Bearer YOUR_API_KEY"
```

**Check:** Treat user IDs as text. Find a person's ID with [Find Users and Resources by Name, Email or Role](https://api.exhibitday.com/Help/V1?guide=find-people). To find unassigned Tasks, send `filter_by_assignee_user_id=null`.

## Step 4: Find Tasks due in a date range

Find Incomplete Tasks with a Due Date in March 2027. Send dates as `YYYY-MM-DD`.

```bash
curl -X GET "https://api.exhibitday.com/v1/tasks?filter_by_due_date_greater_than_or_equal_to=2027-03-01&filter_by_due_date_smaller_than_or_equal_to=2027-03-31&filter_by_incomplete_only=true&%24return_task_lites=true&%24limit=50&%24offset=0" -H "Authorization: Bearer YOUR_API_KEY"
```

**Check:** You can also send `today`, `yesterday` or `tomorrow`. They use your workspace's time zone. Tasks with no Due Date aren't included.

## Step 5: Combine filters and read every page

Add any of the Tasks list's other filters. They work together with your searches. This request asks for the second page of Completed Tasks in the Task Board's General Tasks section.

```bash
curl -X GET "https://api.exhibitday.com/v1/tasks?filter_by_general_tasks_only=true&filter_by_completed_only=true&%24return_task_lites=true&%24limit=50&%24offset=50" -H "Authorization: Bearer YOUR_API_KEY"
```

Other filters you can add:

| To find | Send |
| --- | --- |
| Tasks for one Event | `filter_by_event_id` |
| Tasks in the General Tasks section, not tied to an Event | `filter_by_general_tasks_only=true` (not with `filter_by_event_id`) |
| Incomplete or Completed Tasks | `filter_by_incomplete_only=true`, or `filter_by_completed_only=true` |
| Tasks with no Due Date | `filter_by_no_due_date=true` (not with the Due Date filters) |
| Tasks that have an Assignee | `filter_by_has_assignee=true` |
| Tasks with a person tagged as a Contributor | `filter_by_contributor_user_ids` with one ID or an array of IDs |
| Tasks with all of several Contributors | Add `filter_by_contributor_user_ids_match_type=all` (the default is `any`) |
| Tasks a person completed | `filter_by_completer_user_id` |
| Your system's ID in an integration field | `filter_by_integration_metadata_field_1` (fields 1 to 5) |
| Tasks added or changed since a time | `filter_by_last_update_timestamp_greater_than_or_equal_to` |
| A different order | `$result_sort`: `create_timestamp_asc`, `create_timestamp_desc`, `last_update_timestamp_asc` or `last_update_timestamp_desc` |

**Check:** Start with `$offset=0`. While `has_more` is true, ask for the next page with the same filters and sort, and add 50 to `$offset`. `total_records` counts every matching Task.

## Try it

## Before running the example

| Value | What to put in it |
| --- | --- |
| `YOUR_API_KEY` | Your workspace API key. Keep it out of shared code and logs. |
| `filter_by_task_name_contains_text` | Part of a Task name in your workspace. The example uses `booth`. |
| `$limit` and `$offset` | The example reads up to 50 matches starting at offset 0. |

**Note.** This example only reads data. It lists Incomplete Tasks whose name contains `booth`.

Copy the complete example in your language and run it. To try another search, change the request to match one of the steps above.

## Complete example program

Code Samples

```bash
curl -X GET "https://api.exhibitday.com/v1/tasks?filter_by_task_name_contains_text=booth&filter_by_incomplete_only=true&%24limit=50&%24offset=0" -H "Authorization: Bearer YOUR_API_KEY"
```

```javascript
const response = await fetch("https://api.exhibitday.com/v1/tasks?" + new URLSearchParams({ "filter_by_task_name_contains_text": "booth", "filter_by_incomplete_only": "true", "$limit": "50", "$offset": "0" }), {
  method: "GET",
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
```

```python
import requests

response = requests.get(
    "https://api.exhibitday.com/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"filter_by_task_name_contains_text": "booth", "filter_by_incomplete_only": "true", "$limit": "50", "$offset": "0"},
)
print(response.status_code, response.json())
```

```csharp
using System;
using System.Net.Http;
using System.Net.Http.Headers;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.GetAsync("https://api.exhibitday.com/v1/tasks?filter_by_task_name_contains_text=booth&filter_by_incomplete_only=true&%24limit=50&%24offset=0");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
```

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ExhibitDayExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.exhibitday.com/v1/tasks?filter_by_task_name_contains_text=booth&filter_by_incomplete_only=true&%24limit=50&%24offset=0"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}
```

```php
<?php
$curl = curl_init('https://api.exhibitday.com/v1/tasks?filter_by_task_name_contains_text=booth&filter_by_incomplete_only=true&%24limit=50&%24offset=0');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
    throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
```

```ruby
require 'net/http'
require 'uri'

uri = URI('https://api.exhibitday.com/v1/tasks?filter_by_task_name_contains_text=booth&filter_by_incomplete_only=true&%24limit=50&%24offset=0')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end
puts "#{response.code} #{response.body}"
```

```go
package main

import (
    "fmt"
    "io"
    "log"
    "net/http"
)

func main() {
    request, err := http.NewRequest("GET", "https://api.exhibitday.com/v1/tasks?filter_by_task_name_contains_text=booth&filter_by_incomplete_only=true&%24limit=50&%24offset=0", nil)
    if err != nil { log.Fatal(err) }
    request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    response, err := (&http.Client{}).Do(request)
    if err != nil { log.Fatal(err) }
    defer response.Body.Close()
    body, err := io.ReadAll(response.Body)
    if err != nil { log.Fatal(err) }
    fmt.Printf("%d %s\n", response.StatusCode, body)
}
```

## Example response

Response 200 — OK 304 — Not Modified 400 — Bad Request 401 — Unauthorized 429 — Too Many Requests 500 — Internal Server Error

Example Successful request

```json
{
  "records_found": 1,
  "total_records": 1,
  "has_more": false,
  "list_type": "task",
  "list_data": [
    {
      "id": 12345,
      "exhibitday_url": "https://www.exhibitday.com/Workspace/TaskView/98765?tid=12345",
      "event_task_section_id": null,
      "event_task_section": null,
      "display_rank": 0,
      "name": "Sample task",
      "due_date": null,
      "assignee": null,
      "assigned_by": null,
      "contributors": [
        {
          "id": "11111111-2222-4333-8444-555555555555",
          "first_name": "Jane",
          "last_name": "Smith",
          "display_name": "Jane Smith",
          "email": "jane@example.invalid",
          "type": "user",
          "workspace_role": "team_member",
          "is_active": true
        },
        {
          "id": "66666666-7777-4888-8999-aaaaaaaaaaaa",
          "first_name": "Alex",
          "last_name": "Morgan",
          "display_name": "Alex Morgan",
          "email": "alex@example.invalid",
          "type": "user",
          "workspace_role": "team_member",
          "is_active": true
        }
      ],
      "is_completed": false,
      "task_completed_timestamp": null,
      "task_completed_by": null,
      "details": "",
      "comments": null,
      "event": null,
      "task_created_by": {
        "id": "11111111-2222-4333-8444-555555555555",
        "first_name": "Jane",
        "last_name": "Smith",
        "display_name": "Jane Smith",
        "email": "jane@example.invalid",
        "type": "user",
        "workspace_role": "team_member",
        "is_active": true
      },
      "task_created_timestamp": "2026-11-22T17:00:00Z",
      "task_last_update_timestamp": "2026-11-22T17:00:00Z",
      "integration_metadata_field_1": "",
      "integration_metadata_field_2": "",
      "integration_metadata_field_3": "",
      "integration_metadata_field_4": "",
      "integration_metadata_field_5": ""
    }
  ]
}
```

Note: GET /v1/tasks - HTTP 200. One page of Incomplete Tasks whose names contain booth. Use your own search text and keep the returned Task IDs.

Note: There is no response body. Keep using your cached response.

```json
{
  "status_code": 400,
  "status": "Bad Request",
  "message": "HTTP method override is not supported.",
  "error_code": "invalid_request",
  "errors": [
    "Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
  ],
  "error_params": [
    "X-HTTP-Method-Override"
  ],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 400,
  "status": "Bad Request",
  "message": "filter_by_contributor_user_ids must be one user ID or an array of user IDs. Each ID is text of 1 to 128 characters; numbers, true/false, null, blank values and objects are not IDs. For example, send \"user-id\" or [\"user-id\",\"other-user-id\"].",
  "error_code": "invalid_request",
  "errors": [
    "filter_by_contributor_user_ids must be one user ID or an array of user IDs. Each ID is text of 1 to 128 characters; numbers, true/false, null, blank values and objects are not IDs. For example, send \"user-id\" or [\"user-id\",\"other-user-id\"]."
  ],
  "error_params": [
    "filter_by_contributor_user_ids"
  ],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 400,
  "status": "Bad Request",
  "message": "filter_by_contributor_user_ids_match_type must be any or all. Leave it out to match at least one selected person.",
  "error_code": "invalid_request",
  "errors": [
    "filter_by_contributor_user_ids_match_type must be any or all. Leave it out to match at least one selected person."
  ],
  "error_params": [
    "filter_by_contributor_user_ids_match_type"
  ],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 401,
  "status": "Unauthorized",
  "message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
  "error_code": "missing_api_key",
  "errors": [
    "Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
  ],
  "error_params": [
    "api_key"
  ],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 401,
  "status": "Unauthorized",
  "message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
  "error_code": "invalid_api_key",
  "errors": [
    "Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
  ],
  "error_params": [
    "api_key"
  ],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 401,
  "status": "Unauthorized",
  "message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
  "error_code": "api_access_disabled",
  "errors": [
    "Nothing was read or changed."
  ],
  "error_params": [
    "api_key"
  ],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 429,
  "status": "Too Many Requests",
  "message": "Error 429 - Too Many Requests",
  "error_code": "rate_limited",
  "errors": [
    "Error 429 - Too Many Requests"
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 500,
  "status": "Unexpected Internal Error",
  "message": "An unexpected error occurred. Please try again later.",
  "error_code": "internal_error",
  "errors": [
    "An unexpected error occurred. Please try again later."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

Note: Use the request_id from your own response when contacting support.

```json
{
  "status_code": 500,
  "status": "Unexpected Internal Error",
  "message": "An unexpected error occurred. Please try again later.",
  "error_code": "internal_error",
  "errors": [
    "Check whether your change was saved before trying again."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

The curl example uses Bash. Node.js needs version 18 or later (save as .mjs). Python uses Requests. C# needs a .NET 8 console project (Program.cs). Java needs Java 11 or later (ExhibitDayExample.java). PHP needs PHP with cURL. Ruby and Go use their standard libraries.

## Things to keep in mind

- Without `$result_sort`, Tasks are grouped by Event in Event start date order, then listed in their Task Board order.
- Tasks can't be assigned to Resources. To pick an Assignee, use `GET /v1/references/users_and_resources` with `filter_by_can_have_tasks_assigned=true`.
- Task Lite results are faster and leave out Details, Contributors and comments. Use full results when you need them.
- Integration field filters match the whole value. They ignore letter case and spaces before or after it, but accents count. A blank value is ignored.

## Related guides

- [Create Tasks from Forms, Tickets or Other Apps](https://api.exhibitday.com/Help/V1?guide=create-tasks)
- [Find Users and Resources by Name, Email or Role](https://api.exhibitday.com/Help/V1?guide=find-people)
- [Search Events by Name, Custom Field or Tag](https://api.exhibitday.com/Help/V1?guide=search-events)
- [Keep Another System Updated with Event and Task Changes](https://api.exhibitday.com/Help/V1?guide=sync-changes)
