> ## Documentation Index > Fetch the complete documentation index at: https://docs.altss.com/llms.txt > Use this file to discover all available pages before exploring further. # Read an organization-owned run > Read a run and its purchased result from the credential organization. Reopening a settled result does not spend again; unpaid results remain private. Requires the API channel and company.read. Only company.dossier and company.financial_research runs belonging to this credential organization are available. ## OpenAPI ````yaml /console-openapi.json get /v1/console/runs/{runId} openapi: 3.1.1 info: title: Altss Console machine API version: '2026-11-11' description: >- A separate description of the deployed protected Console REST, MCP and agent-authorization interfaces. The public website and documentation readers remain anonymous and are described separately. company.read is necessary but not sufficient: approved channels, verified tenant admission, current terms, per-tool eligibility, data rights, spending limits, explicit purchase approval and confirmed funding remain enforced. OAuth grant extensions below describe implemented protocols; generic OpenAPI tools may ignore extensions and cannot infer an authorization-code or device flow. x-altss-source-commit: d2432ba2f34a58ed7936598fb5b42dfbf50c6637 servers: - url: https://console.altss.com security: [] tags: - name: Console REST - name: Console MCP - name: Console authorization externalDocs: url: https://console.altss.com/auth.md description: Authoritative Console authorization and human-approval guide paths: /v1/console/runs/{runId}: get: tags: - Console REST summary: Read an organization-owned run description: >- Read a run and its purchased result from the credential organization. Reopening a settled result does not spend again; unpaid results remain private. Requires the API channel and company.read. Only company.dossier and company.financial_research runs belonging to this credential organization are available. operationId: getConsoleRun parameters: - in: path name: runId required: true schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ responses: '200': description: >- Organization-owned run, with unpaid, failed or restricted output withheld by the canonical reader. content: application/json: schema: type: object additionalProperties: true '400': description: >- Invalid request, unsupported operation or invalid grant; response shape depends on the transport. content: application/json: schema: type: object additionalProperties: true '401': description: >- Missing, malformed, unknown, revoked or wrong-channel credential. These failures are deliberately indistinguishable. headers: WWW-Authenticate: schema: type: string description: >- Plain Bearer for REST; the canonical MCP endpoint includes the exact MCP protected-resource metadata URL. '403': description: >- Current account, organization, permission, data-rights or other authorization checks deny this request. '404': description: No accessible run. '429': description: Rate limit exceeded. Do not retry rapidly. '503': description: >- Unavailable or uncertain outcome. For a paid run, preserve the idempotency key and inspect the run; do not assume no charge occurred. security: - ConsoleAgentGrant: - company.read - ConsoleKey: [] components: securitySchemes: ConsoleAgentGrant: type: oauth2 description: >- Console-issued bearer credential acquired through the implemented user-claimed service_auth grant or its one-time Console-issued JWT assertion rotation. These are explicitly named specification extensions, not standard authorization-code, client-credentials or device flows. Follow the authoritative auth.md guide; extension support is optional to clients. x-oauth-authorization-server-metadata: https://console.altss.com/.well-known/oauth-authorization-server flows: x-altss-claim: grant_type: urn:workos:agent-auth:grant-type:claim tokenUrl: https://console.altss.com/v1/console/agent-auth/token scopes: company.read: >- Read the eligible Console catalog and the organization's purchased results; request qualified financial-research quotes and explicitly authorized executions, subject to approved channels, current terms, data rights, credential limits and confirmed funding. This scope does not grant unrestricted private data or authorize a purchase. identityUrl: https://console.altss.com/v1/console/agent-auth/identity documentationUrl: https://console.altss.com/auth.md codeChallengeMethods: - S256 description: >- Existing custom user-claimed service flow. Registration alone grants no access; explicit matching-human approval, original verifier and exact resource are required. x-jwt-bearer: grant_type: urn:ietf:params:oauth:grant-type:jwt-bearer tokenUrl: https://console.altss.com/v1/console/agent-auth/token scopes: company.read: >- Read the eligible Console catalog and the organization's purchased results; request qualified financial-research quotes and explicitly authorized executions, subject to approved channels, current terms, data rights, credential limits and confirmed funding. This scope does not grant unrestricted private data or authorize a purchase. documentationUrl: https://console.altss.com/auth.md description: >- Only the short-lived assertion issued by this Console is accepted, once, with its original verifier and resource. It rotates the same principal and does not trust external assertions or implement refresh_token. ConsoleKey: type: http scheme: bearer bearerFormat: opaque description: >- Existing manually created Console credential. It must already grant company.read and the operation's API or MCP channel. The empty OpenAPI security requirement array for this non-OAuth scheme is not a scope exemption. Auth0 account tokens are not accepted. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.