List a customer's issues

GET

/customers/{customerId}/issues

const url = 'https://api.usesonora.com/v1/customers/example/issues?sort=-createdAt&limit=25';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.usesonora.com/v1/customers/example/issues?sort=-createdAt&limit=25' \
  --header 'Authorization: Bearer <token>'

One customer’s issues, archived customer or not, with the filters and order of GET /issues. Name the customer by its Sonora id, or by your own system’s id with idType.

Requires the issues:read scope.

Authorizations

apiKey
oauth
issues:read

Parameters

Path Parameters

customerId

required

string

The customer’s Sonora id — or, with idType, its id in another system, or its domain.

Query Parameters

status

string

Comma-separated statuses, matched without regard to case; issues in any of them match.

priority

string

Comma-separated priorities, matched without case.

createdAfter

string format: date-time

Only issues Sonora recorded at or after this instant (createdAt).

updatedAfter

string format: date-time

Only issues changed at or after this instant. With sort=updatedAt, resume a sync from the last updatedAt you saw, a few minutes back.

sort

string

default: -createdAt

Allowed values: -createdAt updatedAt

-createdAt: newest first (the default). updatedAt: oldest change first, for syncing.

limit

integer

default: 25 >= 1 <= 100

Page size, 1–100.

cursor

string

<= 200 characters

The previous page’s nextCursor, unchanged. Omit for the first page.

include

string

Comma-separated optional parts of the response: totalCount, quotes.

idType

string

How id names the account: sonora (the default; Sonora’s customer id), salesforce, hubspot, domain, or custom_field:<key>. So GET /customers/001Ab…?idType=salesforce finds a customer by its Salesforce Account id.

Responses

200

A page of the customer’s issues.

application/json

object

data

required

Array<object>

A problem a customer raised.

object

required

string

customer

required

The customer a record belongs to; GET /customers/{customerId} has the rest of it.

object

required

string

name

required

string

title

required

string

summary

required

string

category

required

string | null

status

required

As the source system spells it (open, Pending, Closed - Duplicate, …); null when it gave none.

string | null

priority

required

As the source system or Sonora’s analysis set it.

string | null

occurredAt

required

Any of:

string
null

string format: date-time

lastActivityAt

required

Any of:

string
null

string format: date-time

sourceCount

required

integer

sources

required

Every source, oldest link first.

Array<object>

A ticket, email, call or conversation an issue or feature request was found in.

object

type

required

Where Sonora found it: zendesk_support_tickets, salesforce_support_cases, intercom_tickets, pylon_issues, gmail, gong_calls, slack_conversations, aha_ideas, … New types are added as Sonora reads new systems.

string

externalId

required

The record’s id in that system — a ticket, case, message or idea id. Null where Sonora keeps none.

string | null

quotes

Only with ?include=quotes: the customer’s own words, in the issue’s order.

Array<object>

A customer’s own words behind an issue or feature request.

object

text

required

What the person said or wrote, verbatim.

string

personName

required

string | null

personTitle

required

string | null

personEmail

required

A person at the customer, where Sonora knows their address.

string | null

createdAt

required

When Sonora recorded the issue.

string format: date-time

updatedAt

required

Moves on any change to the issue, including a new source being linked.

string format: date-time

links

required

object

self

required

This resource’s canonical URL on the API host.

string

totalCount

Only with ?include=totalCount: every match under the same filters.

integer

nextCursor

required

Pass as cursor for the next page; null on the last page.

string | null

Example^generated

{
  "data": [
    {
      "id": "example",
      "customer": {
        "id": "example",
        "name": "example"
      },
      "title": "example",
      "summary": "example",
      "category": "example",
      "status": "example",
      "priority": "example",
      "occurredAt": "2026-04-15T12:00:00Z",
      "lastActivityAt": "2026-04-15T12:00:00Z",
      "sourceCount": 1,
      "sources": [
        {
          "type": "example",
          "externalId": "example"
        }
      ],
      "quotes": [
        {
          "text": "example",
          "personName": "example",
          "personTitle": "example",
          "personEmail": "example"
        }
      ],
      "createdAt": "2026-04-15T12:00:00Z",
      "updatedAt": "2026-04-15T12:00:00Z",
      "links": {
        "self": "example"
      }
    }
  ],
  "totalCount": 1,
  "nextCursor": "example"
}

400

invalid_request: A parameter or body field is missing, malformed or unknown; details.issues names each.

application/json

The one error shape every endpoint answers with.

object

error

required

object

code

required

Stable snake_case code to branch on; see the error table.

string

message

required

For humans; may change.

string

details

object

key

additional properties

requestId

required

Quote it when asking for help.

string | null

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

401

unauthorized: The Authorization header is missing, or the key is invalid, revoked or expired.

application/json

The one error shape every endpoint answers with.

object

error

required

object

code

required

Stable snake_case code to branch on; see the error table.

string

message

required

For humans; may change.

string

details

object

key

additional properties

requestId

required

Quote it when asking for help.

string | null

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

403

insufficient_scope: The key or token lacks the scope this endpoint needs, and details.required names it; or an OAuth access token called an endpoint only an API key can.

application/json

The one error shape every endpoint answers with.

object

error

required

object

code

required

Stable snake_case code to branch on; see the error table.

string

message

required

For humans; may change.

string

details

object

key

additional properties

requestId

required

Quote it when asking for help.

string | null

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

404

customer_not_found: No customer matches the id (and idType) in the path.

application/json

The one error shape every endpoint answers with.

object

error

required

object

code

required

Stable snake_case code to branch on; see the error table.

string

message

required

For humans; may change.

string

details

object

key

additional properties

requestId

required

Quote it when asking for help.

string | null

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

429

rate_limited: Too many requests for this key; retry after Retry-After seconds.

application/json

The one error shape every endpoint answers with.

object

error

required

object

code

required

Stable snake_case code to branch on; see the error table.

string

message

required

For humans; may change.

string

details

object

key

additional properties

requestId

required

Quote it when asking for help.

string | null

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

500

internal_error: Something went wrong on Sonora’s side. Retry, and quote requestId if it persists.

application/json

The one error shape every endpoint answers with.

object

error

required

object

code

required

Stable snake_case code to branch on; see the error table.

string

message

required

For humans; may change.

string

details

object

key

additional properties

requestId

required

Quote it when asking for help.

string | null

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

Try it

Run this request against your own Sonora workspace. Sign in, pick the workspace, and the page gets an access token that only reads, only what your role covers, for an hour.

GEThttps://api.usesonora.com/v1/customers/{customerId}/issues

customerIdrequiredpathThe customer's Sonora id — or, with `idType`, its id in another system, or its domain.statusqueryComma-separated statuses, matched without regard to case; issues in any of them match.priorityqueryComma-separated priorities, matched without case.createdAfterqueryOnly issues Sonora recorded at or after this instant (`createdAt`).updatedAfterqueryOnly issues changed at or after this instant. With `sort=updatedAt`, resume a sync from the last `updatedAt` you saw, a few minutes back.sortquery`-createdAt`: newest first (the default). `updatedAt`: oldest change first, for syncing.limitqueryPage size, 1–100.cursorqueryThe previous page's `nextCursor`, unchanged. Omit for the first page.includequeryComma-separated optional parts of the response: `totalCount`, `quotes`.idTypequeryHow `id` names the account: `sonora` (the default; Sonora's customer id), `salesforce`, `hubspot`, `domain`, or `custom_field:<key>`. So `GET /customers/001Ab…?idType=salesforce` finds a customer by its Salesforce Account id.

As curl

$SONORA_TOKEN is your access token or an API key; the page never shows the token.

List a customer's issues

Authorizations

Parameters

Path Parameters

Query Parameters

Responses

200

Examplegenerated

400

Examplegenerated

401

Examplegenerated

403

Examplegenerated

404

Examplegenerated

429

Examplegenerated

500

Examplegenerated

Try it

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated