Polaris

Get Run Status, Outputs, And Any Structured Follow-up Artifacts

GEThttps://api.getcovent.com/api/v1/polaris/runs/run_123

Retrieve run status, outputs, and any structured follow-up artifacts.

How to Call

Use one of the examples below to call this endpoint from your own integration.

curl -X GET "https://api.getcovent.com/api/v1/polaris/runs/run_123" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Request

Review headers, parameters, and body fields before calling this endpoint.

AuthorizationstringRequired

Bearer token for the proposed external API contract.

Example: Bearer <API_KEY>
AcceptstringRequired

Response format header.

Example: application/json

idstringRequired

id path parameter.

Example: run_123

Response

200application/json

idstringRequired

id response field.

Example: run_123
statusstringRequired

status response field.

Example: completed
intentstringRequired

intent response field.

Example: investor_lookup
messagesarrayRequired

messages response field.

Example: [{"id":"msg_124","role":"assistant","content":"Jordan Lee submitted 4 offers in the last 90 days.","created_at":"2026-04-17T20:02:06Z"}]
approvalsarrayRequired

approvals response field.

Example: []
started_atstringRequired

started_at response field.

Example: 2026-04-17T20:02:00Z
completed_atstringRequired

completed_at response field.

Example: 2026-04-17T20:02:06Z
error_messagenullRequired

error_message response field.

Example: null

Response Example

{
  "id": "run_123",
  "status": "completed",
  "intent": "investor_lookup",
  "messages": [
    {
      "id": "msg_124",
      "role": "assistant",
      "content": "Jordan Lee submitted 4 offers in the last 90 days.",
      "created_at": "2026-04-17T20:02:06Z"
    }
  ],
  "approvals": [],
  "started_at": "2026-04-17T20:02:00Z",
  "completed_at": "2026-04-17T20:02:06Z",
  "error_message": null
}