# Send a Weekly Progress Report for Events and Tasks

> List your upcoming shows, count last month's Events and Completed Tasks, and give each Assignee a list of the Tasks due next week.

This is the Markdown copy of https://api.exhibitday.com/Help/V1?guide=weekly-progress-report 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

List your upcoming shows, count last month's Events and Completed Tasks, and give each Assignee a list of the Tasks due next week.

Example use case

Every Monday your events manager wants one page: the shows coming up, how last month went, and what each person has due in the week ahead.

What you'll end up with

The lists for your report: upcoming Events, last month's Events and Completed Tasks, and each Assignee's Tasks due next week, with their email address.

Before you start

Have a workspace API key. Decide how far ahead “upcoming” should look. The example uses 90 days.

Good to know

The requests only read. Build the report from the results and send it with your own email tool or chat app.

## At a glance

Time to try

About 10 minutes

Effect on your data

Read-only

Endpoints

3

The requests only read Events, Tasks and people. They change nothing and send no email.

- [`GET /v1/events`](https://api.exhibitday.com/Help/V1?epf=1#get-v1-events)
- [`GET /v1/tasks`](https://api.exhibitday.com/Help/V1?epf=2#get-v1-tasks)
- [`GET /v1/references/users_and_resources`](https://api.exhibitday.com/Help/V1?epf=3#get-v1-references-users_and_resources)

## How it works

1. List the Events that start in the next 90 days.
2. List the Events that took place last month and count the Tasks Completed last month.
3. List each Assignee's Incomplete Tasks due next week, with their email address.

## Build the report

The examples assume you build the report on Sunday, November 22, 2026. Next week is November 23 to 29, and last month is October 2026. Work out last month and next week in your workspace's time zone.

## Step 1: List upcoming shows

Find the Events that start between tomorrow and 90 days from now, earliest first.

```bash
curl -X GET "https://api.exhibitday.com/v1/events?filter_by_start_date_greater_than_or_equal_to=2026-11-23&filter_by_start_date_smaller_than_or_equal_to=2027-02-20&%24return_event_lites=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 Event",
      "start_date": "2026-12-22",
      "end_date": "2026-12-24",
      "participation_type": "Committed",
      "format": "In-Person"
    }
  ]
}
```

**Check:** Print each Event's name, dates, Participation Status (`participation_type`) and format (In-Person, Virtual or Hybrid). Add `filter_by_event_participation_type_id=1` to list only Committed Events. For every upcoming Event, including Events in progress, send `filter_by_event_start_date_category=upcoming` instead of the two date filters.

## Step 2: List the Events that took place last month

Find every Event that overlaps last month: it started on or before the last day of the month and ended on or after its first day.

```bash
curl -X GET "https://api.exhibitday.com/v1/events?filter_by_start_date_smaller_than_or_equal_to=2026-10-31&filter_by_end_date_greater_than_or_equal_to=2026-10-01&%24return_event_lites=true&%24limit=50&%24offset=0" -H "Authorization: Bearer YOUR_API_KEY"
```

**Check:** `total_records` is the number of Events. List each one with its Participation Status (`participation_type`) so the report shows which shows you attended. An Event that ran from September 30 to October 2 counts, because part of it was in October. Don't send `filter_by_event_start_date_category` here. It overrides the date filters.

## Step 3: Count the Tasks Completed last month

There's no completion-date filter, so ask for Completed Tasks changed since the first day of last month, then count the ones Completed in that month.

```bash
curl -X GET "https://api.exhibitday.com/v1/tasks?filter_by_completed_only=true&filter_by_last_update_timestamp_greater_than_or_equal_to=2026-10-01T00%3A00%3A00Z&%24return_task_lites=true&%24limit=50&%24offset=0" -H "Authorization: Bearer YOUR_API_KEY"
```

**Check:** Count only Tasks whose `task_completed_timestamp_est` falls in last month. Despite its name, this Task Lite field holds the UTC time, the same value as `task_completed_timestamp` in a full Task. A Task Completed last month was last changed then or later, so this filter never leaves it out.

## Step 4: List each Assignee's Tasks due next week

Find Incomplete Tasks with an Assignee and a Due Date next week, then group them by person.

```bash
curl -X GET "https://api.exhibitday.com/v1/tasks?filter_by_incomplete_only=true&filter_by_has_assignee=true&filter_by_due_date_greater_than_or_equal_to=2026-11-23&filter_by_due_date_smaller_than_or_equal_to=2026-11-29&%24return_task_lites=true&%24limit=50&%24offset=0" -H "Authorization: Bearer YOUR_API_KEY"
```

**Check:** In Task Lite results, group rows by `assignee_user_id` and print `assignee_display_name`, the Due Date, the Task name and `event.name`. A General Task has no Event. For one person only, send `filter_by_assignee_user_id` instead of `filter_by_has_assignee`.

## Step 5: Look up each Assignee's email address

List the people who can be assigned Tasks. This list comes back in one response, without pages.

```bash
curl -X GET "https://api.exhibitday.com/v1/references/users_and_resources?filter_by_can_have_tasks_assigned=true" -H "Authorization: Bearer YOUR_API_KEY"
```

**Example response (shortened)**

```json
{
  "list_data": [
    {
      "id": "11111111-2222-4333-8444-555555555555",
      "display_name": "Jane Smith",
      "email": "jane@example.invalid",
      "can_have_tasks_assigned": true
    }
  ]
}
```

**Check:** Match `id` to `assignee_user_id` from Step 4. Treat user IDs as text.

## 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_due_date_greater_than_or_equal_to` and `filter_by_due_date_smaller_than_or_equal_to` | The first and last day of next week as `YYYY-MM-DD`. The example uses November 23 to 29, 2026. |
| `$limit` and `$offset` | The example reads up to 50 matches starting at offset 0. |

**Note.** This example only reads data. It lists the Incomplete Tasks with an Assignee that are due next week. It sends no email.

Copy the complete example in your language and run it. To try another step, 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_incomplete_only=true&filter_by_has_assignee=true&filter_by_due_date_greater_than_or_equal_to=2026-11-23&filter_by_due_date_smaller_than_or_equal_to=2026-11-29&%24return_task_lites=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_incomplete_only": "true", "filter_by_has_assignee": "true", "filter_by_due_date_greater_than_or_equal_to": "2026-11-23", "filter_by_due_date_smaller_than_or_equal_to": "2026-11-29", "$return_task_lites": "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_incomplete_only": True, "filter_by_has_assignee": True, "filter_by_due_date_greater_than_or_equal_to": "2026-11-23", "filter_by_due_date_smaller_than_or_equal_to": "2026-11-29", "$return_task_lites": 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_incomplete_only=true&filter_by_has_assignee=true&filter_by_due_date_greater_than_or_equal_to=2026-11-23&filter_by_due_date_smaller_than_or_equal_to=2026-11-29&%24return_task_lites=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_incomplete_only=true&filter_by_has_assignee=true&filter_by_due_date_greater_than_or_equal_to=2026-11-23&filter_by_due_date_smaller_than_or_equal_to=2026-11-29&%24return_task_lites=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_incomplete_only=true&filter_by_has_assignee=true&filter_by_due_date_greater_than_or_equal_to=2026-11-23&filter_by_due_date_smaller_than_or_equal_to=2026-11-29&%24return_task_lites=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_incomplete_only=true&filter_by_has_assignee=true&filter_by_due_date_greater_than_or_equal_to=2026-11-23&filter_by_due_date_smaller_than_or_equal_to=2026-11-29&%24return_task_lites=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_incomplete_only=true&filter_by_has_assignee=true&filter_by_due_date_greater_than_or_equal_to=2026-11-23&filter_by_due_date_smaller_than_or_equal_to=2026-11-29&%24return_task_lites=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 due next week, each with its Assignee. Group them by Assignee to build each person's list.

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

- Read every page. While `has_more` is true, ask for the next page with the same filters and add 50 to `$offset`.
- Due Date filters and the Events date filters take calendar dates. `today`, `yesterday` and `tomorrow` work in the Due Date filters and use your workspace's time zone.
- Completion times are in UTC. A Task Completed late on the last evening of the month in your time zone may count in the next month.
- Tasks with no Due Date and unassigned Tasks aren't in Step 4. Add `filter_by_no_due_date=true` or `filter_by_assignee_user_id=null` in a separate request to report them.
- Tasks can't be assigned to Resources, so every Assignee in Step 4 is a user. Someone who has since left your workspace may still be the Assignee but isn't in Step 5's list, so check those Tasks yourself.

## Related guides

- [Search Events by Name, Custom Field or Tag](https://api.exhibitday.com/Help/V1?guide=search-events)
- [Search Tasks by Name, Details, Assignee and Due Date](https://api.exhibitday.com/Help/V1?guide=search-tasks)
- [Find Users and Resources by Name, Email or Role](https://api.exhibitday.com/Help/V1?guide=find-people)
- [Export Event Costs to Excel or a Reporting Tool](https://api.exhibitday.com/Help/V1?guide=export-event-costs)
