Read a launch with its jobs, runs, receipts, and spend
curl --request GET \
--url https://useorgx.com/api/v1/launches/{launchId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://useorgx.com/api/v1/launches/{launchId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/launches/{launchId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"launch_id": "1d2c3b4a-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"initiative_id": "4b014796-6b1e-4a4f-9a35-2b6a4d1c8a10",
"state": "dispatched",
"aggregate_version": 2,
"created_at": "2026-08-19T21:00:00.000Z",
"model_tier": "balanced",
"effective_autonomy": "gated",
"scope": {
"workstream_id": "9c1f2e77-3c58-4a1e-9d0b-6a2f8e4b1c33",
"task_id": null
},
"cost": {
"server_estimate_cents": 500,
"cost_ceiling_cents": 1000,
"reserved_cents": 500,
"settled_cents": 0
},
"jobs": [
{
"workstream_id": "9c1f2e77-3c58-4a1e-9d0b-6a2f8e4b1c33",
"job_id": "3f4e5d6c-7b8a-4901-a2b3-c4d5e6f70819",
"status": "running",
"block_code": null
}
],
"runs": [
{
"id": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d",
"status": "running",
"outcome_kind": null,
"cost_cents": 12
}
],
"receipts": [
{
"id": "8c7b6a59-4d3e-4f21-a0b9-c8d7e6f5a4b3",
"cost_estimate_cents": 500,
"settlement_status": "reserved"
}
],
"blocking_decision": null
},
"meta": {
"apiVersion": "1",
"workspaceId": "5be1076d-8fd0-4c0f-847f-fd67fdb935e8",
"projectionStatus": "live_rows"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}Launches
Read a launch with its jobs, runs, receipts, and spend
The state of one launch: which targets dispatched, the runs they produced, the reservation receipts backing them, spend reserved and settled so far, and any decision currently blocking the initiative.
Scope
A launch id outside your workspace is reported exactly like an id that was never issued.
GET
/
launches
/
{launchId}
Read a launch with its jobs, runs, receipts, and spend
curl --request GET \
--url https://useorgx.com/api/v1/launches/{launchId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://useorgx.com/api/v1/launches/{launchId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/launches/{launchId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"launch_id": "1d2c3b4a-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"initiative_id": "4b014796-6b1e-4a4f-9a35-2b6a4d1c8a10",
"state": "dispatched",
"aggregate_version": 2,
"created_at": "2026-08-19T21:00:00.000Z",
"model_tier": "balanced",
"effective_autonomy": "gated",
"scope": {
"workstream_id": "9c1f2e77-3c58-4a1e-9d0b-6a2f8e4b1c33",
"task_id": null
},
"cost": {
"server_estimate_cents": 500,
"cost_ceiling_cents": 1000,
"reserved_cents": 500,
"settled_cents": 0
},
"jobs": [
{
"workstream_id": "9c1f2e77-3c58-4a1e-9d0b-6a2f8e4b1c33",
"job_id": "3f4e5d6c-7b8a-4901-a2b3-c4d5e6f70819",
"status": "running",
"block_code": null
}
],
"runs": [
{
"id": "5a4b3c2d-1e0f-4a9b-8c7d-6e5f4a3b2c1d",
"status": "running",
"outcome_kind": null,
"cost_cents": 12
}
],
"receipts": [
{
"id": "8c7b6a59-4d3e-4f21-a0b9-c8d7e6f5a4b3",
"cost_estimate_cents": 500,
"settlement_status": "reserved"
}
],
"blocking_decision": null
},
"meta": {
"apiVersion": "1",
"workspaceId": "5be1076d-8fd0-4c0f-847f-fd67fdb935e8",
"projectionStatus": "live_rows"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}Authorizations
bearerAuthcookieAuth
OrgX API key, sent as Authorization: Bearer oxk_...
Path Parameters
Launch to read
