Overview
Trademarks
Entities
Portfolios
Watches & Alerts
Reference Data
List Statuses
Copy
curl --request GET \
--url https://api.example.com/v1/statusesCopy
{
"object": "list",
"data": [
{
"object": "status_mapping",
"office_code": "uspto",
"raw_code": "600",
"status_stage": "abandoned",
"status_reason": "failure_to_respond",
"challenge_states": null,
"status_source": "official",
"confidence": 1.0,
"notes": null
},
{
"object": "status_mapping",
"office_code": "uspto",
"raw_code": "800",
"status_stage": "registered",
"status_reason": null,
"challenge_states": null,
"status_source": "official",
"confidence": 1.0,
"notes": "Registered and renewed"
},
{
"object": "status_mapping",
"office_code": "euipo",
"raw_code": "REGISTERED",
"status_stage": "registered",
"status_reason": null,
"challenge_states": null,
"status_source": "official",
"confidence": 1.0,
"notes": null
}
],
"has_more": false,
"pagination": {
"cursor": null
},
"request_id": "req_xyz789"
}
Reference Data
List Statuses
List per-office status code mappings to canonical status stages
GET
/
v1
/
statuses
List Statuses
Copy
curl --request GET \
--url https://api.example.com/v1/statusesCopy
{
"object": "list",
"data": [
{
"object": "status_mapping",
"office_code": "uspto",
"raw_code": "600",
"status_stage": "abandoned",
"status_reason": "failure_to_respond",
"challenge_states": null,
"status_source": "official",
"confidence": 1.0,
"notes": null
},
{
"object": "status_mapping",
"office_code": "uspto",
"raw_code": "800",
"status_stage": "registered",
"status_reason": null,
"challenge_states": null,
"status_source": "official",
"confidence": 1.0,
"notes": "Registered and renewed"
},
{
"object": "status_mapping",
"office_code": "euipo",
"raw_code": "REGISTERED",
"status_stage": "registered",
"status_reason": null,
"challenge_states": null,
"status_source": "official",
"confidence": 1.0,
"notes": null
}
],
"has_more": false,
"pagination": {
"cursor": null
},
"request_id": "req_xyz789"
}
Query Parameters
Filter mappings by office code (e.g.,
uspto, euipo). Omit to return all offices.Response
Returns per-office status code mappings. Each entry maps a raw office-specific status code to a canonical status stage.Show Status mapping object
Show Status mapping object
Always
"status_mapping"Office code (e.g.,
uspto, euipo)Office-specific raw status code
Canonical status stage (e.g.,
filed, registered, abandoned)Reason for this status (may be null)
Any active challenge states (may be null)
Source of the mapping (e.g.,
official, inferred)Confidence score for the mapping
Additional notes about this mapping (may be null)
Copy
{
"object": "list",
"data": [
{
"object": "status_mapping",
"office_code": "uspto",
"raw_code": "600",
"status_stage": "abandoned",
"status_reason": "failure_to_respond",
"challenge_states": null,
"status_source": "official",
"confidence": 1.0,
"notes": null
},
{
"object": "status_mapping",
"office_code": "uspto",
"raw_code": "800",
"status_stage": "registered",
"status_reason": null,
"challenge_states": null,
"status_source": "official",
"confidence": 1.0,
"notes": "Registered and renewed"
},
{
"object": "status_mapping",
"office_code": "euipo",
"raw_code": "REGISTERED",
"status_stage": "registered",
"status_reason": null,
"challenge_states": null,
"status_source": "official",
"confidence": 1.0,
"notes": null
}
],
"has_more": false,
"pagination": {
"cursor": null
},
"request_id": "req_xyz789"
}
⌘I