List issues

List the issues reported by your account, newest first. Pagination is cursor-based: pass the nextCursor from a response as the next request’s cursor, and stop once a response omits it.

GET /issues

List issues

cURL

curl --request GET \
  --url https://restapi.deepdub.ai/api/v1/issues \
  --header 'x-api-key: <api-key>'

200

{
  "issues": [
    {
      "id": "iss_12345abcde",
      "state": "open",
      "rejectionReason": "duplicate report",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "generationId": "<string>",
      "generatedText": "<string>",
      "problemWord": "<string>",
      "voicePromptId": "<string>",
      "type": "hallucinations",
      "locale": "en-US",
      "additionalComments": "<string>",
      "problemSeconds": 123,
      "phoneticHeard": "<string>",
      "phoneticExpected": "<string>"
    }
  ],
  "nextCursor": "<string>"
}

Returns the issues reported by your account, newest first. Only your own reports are visible — an API key never sees another customer’s issues.

Pagination

Paging is cursor-based. Make the first request without a cursor, then pass the nextCursor from each response as the cursor of the next request:

curl "https://restapi.deepdub.ai/api/v1/issues?limit=50" \
  -H "x-api-key: $DEEPDUB_API_KEY"

{
  "issues": [{ "id": "iss_12345abcde", "state": "open" }],
  "nextCursor": "eyJvZmZzZXQiOjUwfQ=="
}

nextCursor is only returned when another page actually exists, so you can loop until it’s absent without ever fetching an empty page:

cursor, all_issues = None, []
while True:
    params = {"limit": 100, **({"cursor": cursor} if cursor else {})}
    page = requests.get(f"{BASE_URL}/issues", params=params, headers=headers).json()
    all_issues.extend(page["issues"])
    cursor = page.get("nextCursor")
    if not cursor:
        break

limit defaults to 50 and is capped at 100 — asking for more returns 100 rather than an error.

Filtering by date

from and to bound the report date inclusively, and each accepts either YYYY-MM-DD or a full RFC3339 timestamp. A bare to date covers that entire UTC day, so to=2026-08-31 includes issues reported at 23:59 that evening.

curl "https://restapi.deepdub.ai/api/v1/issues?from=2026-08-01&to=2026-08-31" \
  -H "x-api-key: $DEEPDUB_API_KEY"

A date that parses as neither format returns 400, as does a from later than the to.

Authorizations

x-api-key · string · header · required

API key for authentication. Must start with dd- prefix.

Headers

x-api-key · string · default: dd-00000000000000000000000065c9cbfe · required

API Key

Query Parameters

limit · integer · default: 50

Maximum issues to return per page. Values above 100 are capped at 100.

Required range: 1 <= x <= 100

cursor · string

The nextCursor value from a previous response. Omit to start from the newest issue.

from · string

Only return issues reported on or after this date. Accepts YYYY-MM-DD or an RFC3339 timestamp.

to · string

Only return issues reported on or before this date. Accepts YYYY-MM-DD or an RFC3339 timestamp; a bare date covers that entire UTC day.

Response

200

application/json

A page of issues

A page of issues reported by your account

issues · object[]

Issues on this page, newest first.

Show child attributes

nextCursor · string

Pass as cursor to fetch the next page. Absent on the last page.