Skip to main content
GET
Use this endpoint to poll the state of a queued ONLINE_PORTAL submission and retrieve the portal applicationNumber and confirmation screenshot once available. Managed-mode organizations use it to track their intake request: the response includes intakeMode: "MANAGED", and method is absent until Cardinal Gray selects the filing path.

​
Status values

Poll until status reaches one of the terminal states. When available, confirmationImg is a presigned URL to a PNG screenshot captured from the state portal.

Authorizations

​
Authorization
string
header
required

API key or Clerk JWT supplied as Authorization: Bearer

Path Parameters

​
id
string
required

Unique identifier of the title entry

​
submissionId
string<uuid>
required

Unique identifier of the submission returned by POST /title/{id}/submit.

Response

Current submission record.

​
submissionId
string<uuid>
required
​
status
enum<string>
required

Lifecycle status of a submission. AWAITING_READINESS is the initial status of a managed-mode intake request — Cardinal Gray's title operations team is preparing the filing; method is absent until a filing path is selected. ACTION_REQUIRED means the state or review team has requested follow-up documents; see feedbackMessage for the explanation and reach out to Cardinal Gray support to submit the additional paperwork.

Available options:
AWAITING_READINESS,
PENDING,
SUBMITTED,
UNDER_REVIEW,
ACTION_REQUIRED,
ACCEPTED,
REJECTED,
CANCELED,
ERROR
​
method
enum<string>

How Cardinal Gray delivers the submission to the state. MAIL states return a packet PDF for the user to print and mail; ONLINE_PORTAL states are driven programmatically by a background worker.

Available options:
MAIL,
ONLINE_PORTAL
​
intakeMode
enum<string>

Present on managed-mode submissions. While the submission is AWAITING_READINESS, method is absent — it appears once Cardinal Gray selects the filing path.

Available options:
MANAGED
​
applicationNumber
string

Application/tracking number returned by the state portal, when available.

​
confirmationImg
string<uri>

Presigned URL to a PNG screenshot captured from the state portal.

​
error
string

Error message if the submission failed.

​
feedbackMessage
string

Feedback surfaced from the state portal or review team — typically an explanation when status is REJECTED or ACTION_REQUIRED.

​
followUps
object[]

Rounds of follow-up documents attached to this submission after the initial POST — each entry records when the documents were uploaded, the feedbackMessage they respond to, and the attachments themselves.