curl -X GET "https://api.cardinalgray.com/title/123e4567-e89b-12d3-a456-426614174000/submit/b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"submissionId": "b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11",
"status": "UNDER_REVIEW",
"method": "ONLINE_PORTAL",
"applicationNumber": "KS-2026-000123",
"confirmationImg": "https://s3.amazonaws.com/...&X-Amz-Signature=..."
}
{
"submissionId": "b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11",
"status": "AWAITING_READINESS",
"intakeMode": "MANAGED"
}
{
"submissionId": "b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11",
"status": "ACCEPTED",
"method": "ONLINE_PORTAL",
"applicationNumber": "KS-2026-000123",
"confirmationImg": "https://s3.amazonaws.com/...&X-Amz-Signature=..."
}
Get Submission
Fetch a submission’s current status, application number, and confirmation screenshot
curl -X GET "https://api.cardinalgray.com/title/123e4567-e89b-12d3-a456-426614174000/submit/b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"submissionId": "b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11",
"status": "UNDER_REVIEW",
"method": "ONLINE_PORTAL",
"applicationNumber": "KS-2026-000123",
"confirmationImg": "https://s3.amazonaws.com/...&X-Amz-Signature=..."
}
{
"submissionId": "b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11",
"status": "AWAITING_READINESS",
"intakeMode": "MANAGED"
}
{
"submissionId": "b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11",
"status": "ACCEPTED",
"method": "ONLINE_PORTAL",
"applicationNumber": "KS-2026-000123",
"confirmationImg": "https://s3.amazonaws.com/...&X-Amz-Signature=..."
}
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 untilstatus reaches one of the terminal states.
| Status | Meaning |
|---|---|
AWAITING_READINESS | Managed intake recorded — Cardinal Gray’s title operations team is preparing the filing |
PENDING | Queued, worker has not started |
SUBMITTED | Worker submitted to the state, awaiting acknowledgement |
UNDER_REVIEW | State/portal has acknowledged and is reviewing |
ACTION_REQUIRED | State needs follow-up documents — see feedbackMessage |
ACCEPTED | State accepted the submission |
REJECTED | State rejected the submission — see error and feedbackMessage |
CANCELED | Cardinal Gray or the user canceled before completion |
ERROR | Unrecoverable error running the worker — see error |
confirmationImg is a presigned URL to a PNG screenshot captured from the state portal.
curl -X GET "https://api.cardinalgray.com/title/123e4567-e89b-12d3-a456-426614174000/submit/b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11" \
-H "Authorization: Bearer YOUR_API_KEY"
{
"submissionId": "b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11",
"status": "UNDER_REVIEW",
"method": "ONLINE_PORTAL",
"applicationNumber": "KS-2026-000123",
"confirmationImg": "https://s3.amazonaws.com/...&X-Amz-Signature=..."
}
{
"submissionId": "b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11",
"status": "AWAITING_READINESS",
"intakeMode": "MANAGED"
}
{
"submissionId": "b8f3c1a2-8a4e-4a8b-9b2f-6e5c1b1a0f11",
"status": "ACCEPTED",
"method": "ONLINE_PORTAL",
"applicationNumber": "KS-2026-000123",
"confirmationImg": "https://s3.amazonaws.com/...&X-Amz-Signature=..."
}
Authorizations
API key or Clerk JWT supplied as Authorization: Bearer
Path Parameters
Unique identifier of the title entry
Unique identifier of the submission returned by POST /title/{id}/submit.
Response
Current submission record.
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.
AWAITING_READINESS, PENDING, SUBMITTED, UNDER_REVIEW, ACTION_REQUIRED, ACCEPTED, REJECTED, CANCELED, ERROR 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.
MAIL, ONLINE_PORTAL Present on managed-mode submissions. While the submission is AWAITING_READINESS, method is absent — it appears once Cardinal Gray selects the filing path.
MANAGED Application/tracking number returned by the state portal, when available.
Presigned URL to a PNG screenshot captured from the state portal.
Error message if the submission failed.
Feedback surfaced from the state portal or review team — typically an explanation when status is REJECTED or ACTION_REQUIRED.
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.
Show child attributes
Show child attributes