Skip to content
SonoraSonora API

Get a feature request

GET
/feature-requests/{featureRequestId}
curl --request GET \
  --url https://api.usesonora.com/v1/feature-requests/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>'

One feature request with its sources, and its quotes with include=quotes.

Requires the feature-requests:read scope.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
featureRequestId
required
string format: uuid

Query Parameters

Section titled “Query Parameters”
include
string

Comma-separated optional parts of the response: quotes.

Responses

Section titled “Responses”

200

Section titled “200”

The feature request.

Media typeapplication/json

A capability a customer asked for.

object
id
required
string
customer
required

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

object
id
required
string
name
required
string
title
required
string
summary
required
string | null
category
required
string | null
status
required

open, pending and in_review are still waiting on an answer; others vary.

string
priority
required
string | null
requestedAt
required
Any of:
string format: date-time
requestedBy
required

Who asked, where the source names them; otherwise what found it (Meeting Transcript Analysis).

string | null
estimatedValue
required

What the request is worth, in your workspace’s currency, where one was set.

number | null
occurredAt
required
Any of:
string format: date-time
lastActivityAt
required
Any of:
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, source by source.

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 request.

string format: date-time
updatedAt
required

Moves when the request itself changes. A new source being linked may not move it.

string format: date-time
links
required
object
self
required

This resource’s canonical URL on the API host.

string
Examplegenerated
{
  "id": "example",
  "customer": {
    "id": "example",
    "name": "example"
  },
  "title": "example",
  "summary": "example",
  "category": "example",
  "status": "example",
  "priority": "example",
  "requestedAt": "2026-04-15T12:00:00Z",
  "requestedBy": "example",
  "estimatedValue": 1,
  "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"
  }
}

400

Section titled “400”

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

Media typeapplication/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
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

401

Section titled “401”

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

Media typeapplication/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
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

403

Section titled “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.

Media typeapplication/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
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

404

Section titled “404”

feature_request_not_found: No feature request with that id.

Media typeapplication/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
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

429

Section titled “429”

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

Media typeapplication/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
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": {
      "additionalProperty": "example"
    },
    "requestId": "example"
  }
}

500

Section titled “500”

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

Media typeapplication/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
Examplegenerated
{
  "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/feature-requests/{featureRequestId}

As curl

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