---
title: "Organisation Orders"
method: GET
path: "/organisations/{id}/orders"
---

# Organisation Orders

`GET /organisations/{id}/orders`

A paginated list of all orders placed by the organisation, sorted by descending placement date.

## Path parameters

- `id` string, required

## Query parameters

- `last` integer — An integer number of items to retrieve before the item represented by the cursor passed in the before parameter. Defaults to 10 with a maximum value of 50.
- `before` string, nullable — An opaque cursor representing the first item in the previously requested page to select items ordered before it. Submit the previously requested page’s start_cursor here when paginated backwards.
- `first` integer — An integer number of items to retrieve after the item represented by the cursor passed in the after parameter. Defaults to 10 with a maximum value of 50.
- `after` string, nullable — An opaque cursor representing the last item in the previously requested page to select items ordered after it. Submit the previously requested page’s end_cursor here when paginated forwards.

## Headers

- `x-client-secret` string, required — A secret token identifying the client connecting to the API

## Response `200`

Successful Response

- PaginatedListResourceOrder
  - `nodes` Order[], required
    - `id` string, required
    - `effective_contract_date` string, date, required
    - `fulfilled_at` string, date-time, nullable, required
    - `buyer_organisation` Organisation, required
      - `id` string, required
      - `name` string, required
      - `domain` string, nullable, required
    - `supplier` Supplier, required
      - `id` string, required
      - `short_description` string, nullable, required
      - `long_description` string, nullable, required
      - `organisation` Organisation, required
        - `id` string, required
        - `name` string, required
        - `domain` string, nullable, required
      - `location` Location, required
        - `country_code` string, required — An ISO 3166-1 alpha-3 country code
        - `country_name` string, required
        - `latitude` number, required — A WGS84 latitude in decimal degrees, between -90 and 90.
        - `longitude` number, required — A WGS84 longitude in decimal degrees, between -180 and 180.
        - `description` string, nullable
    - `status` 'placed' | 'in_progress' | 'completed', required
    - `credits_ordered` CreditQuantity, required
      - `credits` number, required — A representation of the credit quantity as a fractional amount, to 3 decimal places. Where 1 unit represents 1 credit and 1 ton of CO₂e.
      - `credit_kgs` integer, required — A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e. This field can handle bigint values.
    - `credits_delivered` CreditQuantity, required
      - `credits` number, required — A representation of the credit quantity as a fractional amount, to 3 decimal places. Where 1 unit represents 1 credit and 1 ton of CO₂e.
      - `credit_kgs` integer, required — A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e. This field can handle bigint values.
  - `total_count` integer, required
  - `page_info` PageInfo, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `end_cursor` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/isometric/apis/isometric-registry-api.md) · [All operations](https://skmtc.net/isometric/apis/isometric-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isometric/isometric-registry-api/versions/2e31eeb1cb99/schema)