---
title: "Get a single order with line items"
method: GET
path: "/orders/{id}"
tags: ["Orders"]
---

# Get a single order with line items

`GET /orders/{id}`

## Request

- Base URL: `https://www.raceentry.com/restapi/v1`
- URL: `https://www.raceentry.com/restapi/v1/orders/{id}`
- Auth: OAuth 2
  - Authorization code: `/oauth2/authorize`
  - Token URL: `/oauth2/token`

Returns one completed order with nested `line_items` containing registrations,
tickets, merchandise, and donations.

Required permissions: Sales Rep, Director, Reports, Financials, or Sponsors.

## Path parameters

- `id` integer, required

## Response `200`

Order detail with line items

- OrderDetail: Per-order price breakdown. All amounts are decimal strings (2 d.p.).
  - `billing_name` string, nullable
  - `billing_email` string, email, nullable
  - `billing_address` string, nullable
  - `billing_city` string, nullable
  - `billing_state` string, nullable: US state abbreviation
  - `billing_province` string, nullable: Province/region for non-US addresses
  - `billing_zip` string, nullable
  - `billing_country` string, nullable: ISO 3166-1 alpha-3 country code
  - `registration_total` string: Sum of registration prices + paid-answer charges (for non-ticket order types) + photo total (for photo order types).
  - `ticket_total` string: Sum of ticket prices + paid-answer charges (for ticket order types).
  - `merchandise_total` string
  - `photos_total` string
  - `photo_fee_total` string
  - `sponsor_total` string
  - `charity_total` string: Aggregated charity donation amounts for this order.
  - `tip_total` string
  - `tax_total` string
  - `marketplace_tax_total` string: Combined marketplace tax and marketplace shipping tax.
  - `discount_total` string: Promo-code, social, and referral discounts applied to the order.
  - `change_total` string: Registration-edit and transfer fees.
  - `fee_total` string: Processing fees including per-donation fees.
  - `bonus_fee_total` string: Event bonus fees (a subset of fee_total).
  - `gift_card_payment` string: Amount paid by gift card.
  - `order_total` string, required: Authoritative grand total stored on the order.
  - `id` integer, required
  - `finish_date` string, date-time, required: When the order was completed (payment captured)
  - `event_year_id` integer, required
  - `order_type` string, nullable: Order type name
  - `payment_type` string: One of: Credit/Debit, Cash, Check, Upload, Invoice, Split
  - `ccnumber` string, nullable: Masked card number (xxxx-xxxx-xxxx-1234)
  - `transaction_id` string, nullable: Processor transaction id
  - `line_items` object, required
    - `registrations` RegistrationLineItem[], required
      - `id` integer, required
      - `order_id` integer
      - `first_name` string
      - `last_name` string
      - `email` string, email
      - `category` string, nullable
      - `bib_number` integer, nullable
      - `price` string
      - `promo_amount` string
      - `tax_collected` string
      - `processing_fee` string, nullable
    - `tickets` TicketLineItem[], required
      - `id` integer, required
      - `event_time_name` string, nullable: What named event time this ticket is for
      - `event_time_start` string, date-time: What time the ticket event starts
      - `price_label` string, nullable
      - `price` string
      - `tax` string
      - `fee` string
      - `bonus_fee` string
      - `marketplace_tax` string
      - `promo_amount` string
      - `social_discount_amount` string
    - `merchandise` MerchandiseLineItem[], required
      - `id` integer, required
      - `name` string
      - `size` string, nullable
      - `quantity` integer
      - `price` string
      - `subtotal` string
      - `shipping` string
      - `tax_collected` string
      - `processing_fee` string
      - `total` string
    - `donations` DonationLineItem[], required
      - `id` integer, required
      - `donor_name` string, nullable
      - `charity` string, nullable
      - `amount` string, required
      - `fee` string, required
      - `total` string, required
      - `comment` string, nullable
      - `hide_name` boolean: donor chose to hide their name from public display
      - `hide_amount` boolean: donor chose to hide their amount from public display

## Other responses

- `401`: Missing, invalid, or expired bearer token
- `403`: Token not scoped to the event, or insufficient web permission
- `404`: Event, event year, or record not found

---

[API](https://skmtc.dev/raceentry/apis/rest-api-v1.md) - [All operations](https://skmtc.dev/raceentry/apis/rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/raceentry/apis/rest-api-v1/revisions/ee7bc17021a6?raw)