curl --request GET \
--url 'https://api.nsr.stateset.com/v1/responses/{response_id}' \
--header "X-API-Key: $STATESET_NSR_API_KEY"
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"object": "string",
"created_at": 1,
"status": "pending",
"model": "string",
"output": [
{
"type": "standard",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "pending",
"role": "string",
"content": [],
"call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"arguments": "string"
}
],
"output_text": "string",
"usage": {
"input_tokens": 1,
"output_tokens": 1,
"total_tokens": 1
},
"metadata": {},
"previous_response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"x_nsr": {}
}
Get a response handler
Required scope: read
GET
/
v1
/
responses
/
{response_id}
curl --request GET \
--url 'https://api.nsr.stateset.com/v1/responses/{response_id}' \
--header "X-API-Key: $STATESET_NSR_API_KEY"
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"object": "string",
"created_at": 1,
"status": "pending",
"model": "string",
"output": [
{
"type": "standard",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "pending",
"role": "string",
"content": [],
"call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"arguments": "string"
}
],
"output_text": "string",
"usage": {
"input_tokens": 1,
"output_tokens": 1,
"total_tokens": 1
},
"metadata": {},
"previous_response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"x_nsr": {}
}
Required scope:
read
Path parameters
Response
object
Full recursive NSR payload. Present only when the response was created with
include_nsr_metadata.Status codes
| Code | Meaning |
|---|---|
200 | The stored response object, exactly as returned by POST /v1/responses. |
401 | Unauthorized — missing or invalid credentials |
403 | Forbidden — the key/token lacks the required scope |
404 | Unknown response_id (or a response owned by another org). OpenAI-shaped error envelope: {'error': {'message', 'type', 'param', 'code'}}. |
429 | Rate limited — see Retry-After / X-RateLimit-Reset |
curl --request GET \
--url 'https://api.nsr.stateset.com/v1/responses/{response_id}' \
--header "X-API-Key: $STATESET_NSR_API_KEY"
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"object": "string",
"created_at": 1,
"status": "pending",
"model": "string",
"output": [
{
"type": "standard",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "pending",
"role": "string",
"content": [],
"call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"name": "Two-Person Tent",
"arguments": "string"
}
],
"output_text": "string",
"usage": {
"input_tokens": 1,
"output_tokens": 1,
"total_tokens": 1
},
"metadata": {},
"previous_response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"x_nsr": {}
}
Last modified on August 31, 2026