> ## Documentation Index
> Fetch the complete documentation index at: https://docs.proxyjam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get order

> Retrieve the details of a specific order.

Returns full details for a single order, including proxy credentials if the order is active.

## Path parameters

<ParamField path="order_id" type="string" required>
  UUID of the order.
</ParamField>

## Response

Same shape as [Create order response](/api/orders/create-order#response).

<Note>
  You can only retrieve orders that belong to your account. Requesting another user's order returns `403 Forbidden`.
</Note>

<Note id="response-mobile">
  **Mobile rotating orders** return a flat live-snapshot shape, fetched
  from the upstream provider on each request. The response carries
  `"type": "mobile"` and a **superset** of fields: the live state
  (`signature`, `tags`, `current_ip`, `status`) plus durable order
  metadata (`country`, `city`, `isp`, `period_days`, `total_usd`,
  `created_at`, …).

  Two fields look similar but mean different things:
  `status` is the **live proxy state** (e.g. `"active"`) reported by the
  provider on this request; `order_status` is the **order lifecycle**
  value (e.g. `"provisioned"`).

  The Python SDK dispatches automatically: `proxyjam.orders.get()` returns
  either an `Order` or a `MobileProxy` based on the response shape.
</Note>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.proxyjam.com/public/v1/orders/order-uuid-here \
    -H "X-API-Key: pj_AbCdEf..."
  ```

  ```python Python theme={null}
  from proxyjam import ProxyJamClient, MobileProxy

  with ProxyJamClient(api_key="pj_live_...") as proxyjam:
      result = proxyjam.orders.get("order-uuid-here")
      if isinstance(result, MobileProxy):
          print(result.signature, result.current_ip)
      else:
          print(result.status, result.proxy_host, result.proxy_port)
  ```

  ```json Residential Response theme={null}
  {
    "id": "order-uuid-here",
    "status": "active",
    "total_usd": 7.0,
    "proxy_type": "residential",
    "ip_version": "IPv4",
    "protocol": "HTTP",
    "country": "US",
    "quantity": 2,
    "period_days": 30,
    "proxy_access": [
      {
        "id": "1836367",
        "host": "proxy.ProxyJam.com",
        "port": 10001,
        "username": "usr_abc",
        "password": "<proxy-password>",
        "protocol": "HTTP",
        "status": "active",
        "expires_at": "2024-02-14T10:00:00Z",
        "whitelisted_ips": [],
        "bandwidth_total_gb": 1.0,
        "bandwidth_used_gb": 0.0
      }
    ]
  }
  ```

  ```json Mobile Response theme={null}
  {
    "type": "mobile",
    "id": "order-uuid-here",
    "status": "active",
    "auto_renew": true,
    "expires_at": "2026-12-31T23:59:59Z",
    "host": "gw.proxyjam.com",
    "port": 24534,
    "username": "pj_abc",
    "password": "<proxy-password>",
    "current_ip": "203.0.113.10",
    "signature": "android",
    "tags": ["scrape"],
    "whitelisted_ips": [],
    "order_status": "provisioned",
    "proxy_type": "mobile",
    "ip_version": "IPv4",
    "protocol": "HTTP",
    "country": "US",
    "city": null,
    "isp": "T-Mobile",
    "period_days": 1,
    "bandwidth_gb": null,
    "quantity": 1,
    "total_usd": 1.5,
    "total_amount": "1.50",
    "currency": "USD",
    "promo_code_id": null,
    "discount_usd": null,
    "created_at": "2026-12-30T23:59:59Z",
    "updated_at": "2026-12-31T00:15:01Z",
    "payment_intent_id": null,
    "previous_expires_at": null
  }
  ```
</CodeGroup>