---
title: "Retrieve user orders."
method: GET
path: "/orders"
tags: ["Orders"]
---

# Retrieve user orders.

`GET /orders`

## Query parameters

- `start` integer
- `limit` integer
- `after` string
- `before` string

## Response `200`

Success

- object
  - `meta` object
    - `start` integer
    - `limit` integer
    - `after` string
    - `before` string
    - `_endpoint` string
  - `data` Order[]
    - `id` string
    - `status` string
    - `product` object
      - `id` string
      - `name` string
      - `value` string
      - `currency` string
      - `image` string
      - `_href` string
    - `created_time` string
    - `delivered_time` string
    - `redemption_info` string
    - `commission` number
    - `is_gift` boolean — Whether this order is a gift.
    - `gift_info` object — Gift details. Only present when is_gift is true.
      - `gift_id` string
      - `gift_url` string — URL where the recipient can view and redeem the gift.
      - `recipient_name` string
      - `recipient_email` string
      - `sender_name` string
      - `message` string
      - `send_date` string
    - `user` object
      - `id` string
      - `email` string
    - `invoice` object
      - `id` string
      - `_href` string

---

[API](https://skmtc.dev/bitrefill/apis/bitrefill-api-documentation.md) · [All operations](https://skmtc.dev/bitrefill/apis/bitrefill-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitrefill/bitrefill-api-documentation/revisions/09e1bde6bae5/schema)