Get a filing

GET /api/v1/filings/{id}

A signed application's status. The id and token are in the customer's status link, and on the application once signed.

Needs the token for this application or filing.

In the MCP server this is get_filing.

Example

curl https://api.joinopenfile.com/v1/filings/$ID \
  -H "Authorization: Bearer $TOKEN"

Name	Type	Required	Description
`id`	string	Yes	Filing id.

200

Name	Type	Required	Description
`id`	string	No	Filing id.
`object`	`filing`	No	Always `filing`.
`status`	`received`, `changes`, `approved`, `filed`, `declined`	No	Where the filing is.
`status_label`	string	No	The status in plain words.
`note`	string	No	From the attorney, when the status is `changes` or `declined`.
`mark`	string	No	The mark.
`owner`	string	No	The owner.
`basis`	`use`, `itu`	No	Filing basis.
`classes`	array of object	No	The classes filed.
`has_specimen`	boolean	No	True once a specimen is attached.
`signed_by`	string	No	Who signed.
`paid`	boolean	No	True once payment is recorded.
`serial`	string	No	USPTO serial number, once filed.
`filed_at`	string	No	When it was filed.
`uspto_url`	string	No	The USPTO's record, once filed.
`status_url`	string	No	The customer's status link. It contains the token.
`created_at`	string	No	When it was signed.

Status	When
`404`	Not found, or the token is wrong.
`429`	Too many requests.

The body is the error shape.