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

# User Order By Id

> Returns the details of an order belonging to the user (by id).

---

**Authorization**

- Requires a valid API key.
- Required API-key permission(s):
  - Trading (Read)



## OpenAPI

````yaml get /trade/orders/{id}
openapi: 3.0.0
info:
  title: Ripio Gateway
  description: Ripio API - Services documentation.
  version: 0.1.0
  x-logo:
    url: https://cwstatic.nyc3.digitaloceanspaces.com/1996/bitcointrade.png
servers:
  - url: https://api.ripio.com
    description: Production environment
security: []
paths:
  /trade/orders/{id}:
    get:
      tags:
        - Ripio Trade
      summary: Orders - User Order by Id
      description: |-
        Returns the details of an order belonging to the user (by id).

        ---

        **Authorization**

        - Requires a valid API key.
        - Required API-key permission(s):
          - Trading (Read)
      parameters:
        - in: path
          name: id
          required: true
          description: This property was not properly documented
          schema:
            type: string
        - in: header
          name: authorization
          required: true
          description: The API key as a string.
          schema:
            type: string
        - in: header
          name: signature
          required: true
          description: >-
            See the [Generating
            Signature](/static/api/authentication#generating-signature) section
            for more details.
          schema:
            type: string
        - in: header
          name: timestamp
          required: true
          description: >-
            A timestamp in milliseconds. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
        - in: header
          name: timstamp-tolerance
          required: false
          description: >-
            An additional, non-required parameter, that you can send to specify
            the number of milliseconds after the timestamp for the request to be
            valid. See the [Timestamp
            Security](/static/api/authentication#timestamp-security) section for
            more details.
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                description: Ok
                properties:
                  data:
                    properties:
                      id:
                        description: Order identifier
                        type: string
                      create_date:
                        description: Creation datetime
                        type: string
                      executed_amount:
                        description: Executed amount
                        type: number
                      external_id:
                        description: >-
                          External id (this is sent by the user when creating an
                          order, and it's optional)
                        type: string
                      pair:
                        description: Currency pair code
                        type: string
                        example: BTC_BRL
                      remaining_amount:
                        description: Remaining amount
                        type: number
                      remaining_value:
                        description: Remaining value
                        type: number
                      requested_amount:
                        description: Requested amount
                        type: number
                      requested_value:
                        description: Requested value
                        type: number
                      status:
                        description: >-
                          Order status (executed_completely / executed_partially
                          / open / canceled)
                        type: string
                      type:
                        description: Order type (limit / market)
                        type: string
                      total_value:
                        description: Total value
                        type: number
                      side:
                        description: Order side (buy or sell)
                        type: string
                      price:
                        description: Price
                        type: number
                      update_date:
                        description: Datetime of the last update
                        type: string
                      fee:
                        description: Fee from the transaction
                        type: number
                      fill_or_kill:
                        description: >-
                          Exclusive for StopLimit orders, it is used in
                          stop-loss or stop-buy scenarios to initiate selling or
                          buying when the market price reaches the specified
                          stop price
                        type: boolean
                      average_execution_price:
                        description: Average execution price
                        type: number
                      transactions:
                        description: Trades associated with the order
                        items:
                          properties:
                            amount:
                              description: Execution amount in cryptocurrency
                              type: number
                            create_date:
                              description: Timestamp of the execution
                              type: string
                            fee:
                              description: Fee charged for this execution
                              type: number
                            fee_currency:
                              description: Currency code in which the fee was charged
                              type: string
                            total_value:
                              description: Total execution value
                              type: number
                            price:
                              description: Execution price
                              type: number
                          required:
                            - amount
                            - create_date
                            - fee
                            - fee_currency
                            - total_value
                            - price
                          type: object
                        type: array
                    required:
                      - id
                      - create_date
                      - executed_amount
                      - pair
                      - remaining_amount
                      - remaining_value
                      - requested_amount
                      - status
                      - type
                      - total_value
                      - side
                      - price
                      - update_date
                      - fee
                      - fill_or_kill
                      - transactions
                    type: object
                    example:
                      average_execution_price: 42600
                      create_date: '2017-12-08T23:42:54.960Z'
                      external_id: C90796F2-2CC3-4797-9AC3-A16BCC6936F0
                      executed_amount: 0.02347418
                      id: 8DE12108-4643-4E9F-8425-0172F1B96876
                      remaining_amount: 0
                      requested_amount: 0.02347418
                      requested_value: 1000
                      remaining_value: 0
                      pair: BTC_BRL
                      price: 42600
                      side: buy
                      status: executed_completely
                      fee: 0.002
                      total_value: 1000
                      type: limit
                      update_date: '2017-12-13T21:48:48.817Z'
                      transactions:
                        - amount: 0.2
                          create_date: '2020-02-21T20:24:43.433Z'
                          fee: 0.12
                          fee_currency: BTC
                          price: 5000
                          total_value: 1000
                        - amount: 0.2
                          create_date: '2020-02-21T20:49:37.450Z'
                          fee: 0.12
                          fee_currency: BTC
                          price: 5000
                          total_value: 1000
                  error_code:
                    type: number
                    example: null
                  message:
                    type: string
                    example: null
                required:
                  - data
                  - error_code
                  - message
                type: object

````