GET /v1/order-intents/{order_intent_id}

Summary

Retrieve a specific order intent

Description

Retrieves a specific order intent by its ID. Returns the complete intent details including current status and any associated quote/order IDs.

Request Example

curl -X GET "http://127.0.0.1:8000/api/v1/order-intents/oi_abc123def456" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Example

{
  "order_intent_id": "oi_abc123def456",
  "org_id": "user_123",
  "user_id": "user_123",
  "status": "draft",
  "created_at": "2024-01-27T21:12:00Z",
  "updated_at": "2024-01-27T21:12:00Z",
  "board_id": "brd_123",
  "dfm_run_id": "dfm_abc",
  "quantity": 10,
  "lead_time": "standard",
  "ship_to": {
    "country": "US",
    "postal_code": "94107",
    "name": "John Doe"
  },
  "build": {
    "type": "bare_pcb",
    "layers": 4,
    "thickness_mm": 1.6
  },
  "policy_id": null,
  "notes": "Customer notes",
  "latest_quote_id": null,
  "latest_order_id": null
}

Error Codes

This endpoint may return the following error codes:

Code	Status	Meaning
`missing_auth`	401	No Authorization header provided
`invalid_api_key`	403	API key is invalid or missing
`order_intent_not_found`	404	Order intent not found
`forbidden`	403	Not allowed to access this intent

Authentication

This endpoint requires Bearer token authentication: