---
title: "Get order and placement status"
method: GET
path: "/orders/{orderId}"
tags: ["Commerce"]
---

# Get order and placement status

`GET /orders/{orderId}`

## Request

- Base URL: `https://nautilinks.co/api/v1/agent`
- URL: `https://nautilinks.co/api/v1/agent/orders/{orderId}`
- Auth: HTTP bearer

Returns one owned order and the lifecycle state of each link, including the published URL when available.

## Path parameters

- `orderId` string, required

## Response `200`

Detailed order status.

- OrderResponse
  - `ok` true, required
  - `order` Order, required
    - `id` string, required
    - `status` string, required
    - `total_eur` number, required
    - `created_at` string, required
    - `items` OrderItem[], required
      - `site_domain` string, required
      - `format` 'article_unitaire' | 'lien_insere', required
      - `status` 'to_assign' | 'assigned' | 'drafted' | 'in_review' | 'approved' | 'published' | 'verified' | 'cancelled' | 'replaced', required
      - `anchor_text` string, required
      - `target_url` string, uri, required
      - `published_url` string, uri, nullable, required
      - `article_id` integer, nullable, required
      - `tier2_count` integer, required
      - `project_id` integer, nullable, required

## Other responses

- `401`: The API key is missing, invalid, or revoked.
- `403`: The key lacks the required scope or resource ownership.
- `404`: The resource does not exist or is not visible to this account.
- `429`: The request quota or rolling daily order cap was reached.
- `500`: Nautilinks encountered an unexpected internal error.
- `default`: Any non-success status not listed explicitly uses the same typed error envelope.

---

[API](https://skmtc.dev/nautilinks/apis/nautilinks-agent-api.md) · [All operations](https://skmtc.dev/nautilinks/apis/nautilinks-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nautilinks/apis/nautilinks-agent-api/revisions/7a2b1a00e40c?raw)