---
title: Get Fiat Order Details
slug: get-fiat-order-details
docTags: 
createdAt: 2025-05-02T10:40:00.252Z
---

API that returns clients orders matching the *requestId*. This api requires access token that can be generated using [Access Token](docId\:lq-v6fF_2i-h1O3XD5KKA) API.

The response is a list of Orders which matches the given criteria.

1. `orderStatus` : For list of possible status please refer : [Fiat Order Status](docId:-_ZgIyFgAsxS2Uqr272QA)
2. `userAddress` : User's email address
3. `updatedTs` : Last Order updated timestamp in epoch milliseconds
4. `partner` : Downstream partner ID
5. `orderType` : Type of Order. Can be CHECKOUT/PAYOUT
6. `requestId` : Unique ID passed during Order creation
7. `clientId` : Client ID
8. `exchangeCurId` : Name of the currency supported
9. `exchangeAmount` : Currency Amount
10. `paymentMethod` : Payment Method specified for Order
11. `errorReason` : Contains `errorCode` and `errorDesc`. Will be received only in case if status is FAILED. List of possible [Error Codes](docId\:upvtC67WkwGNCSCjVAQ0v)

:::ApiMethodV2
```json
{
  "name": "Get Order Details",
  "method": "GET",
  "url": "https://your-hostname.pay3.app/v1/client/orders?requestId=your-request-id&clientId=your-client-id",
  "description": "Get order details by client's request-id",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "3LjxGJCqZzKeICMDOi23s",
        "language": "curl",
        "code": "curl --location 'https://your-hostname.pay3.app/v1/client/orders?requestId=your-request-id&clientId=your-client-id' \\\n--header 'Accept: application/json' \\\n--header 'Content-Type: application/json' \\\n--header 'access-token: ACCESS-TOKEN-IN-JWT'",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "3LjxGJCqZzKeICMDOi23s"
  },
  "results": {
    "languages": [
      {
        "id": "GC_lbEEV7Jo_hgFNI1cHK",
        "language": "200",
        "customLabel": "",
        "code": "{\n    \"data\": [\n        {\n            \"orderId\": \"4073be54-5903-47c8-820f-17aa12964ba8\",\n            \"orderStatus\": \"FAILED\",\n            \"userAddress\": \"user@email.com\",\n            \"updatedTs\": 1706610264546,\n            \"partner\": \"xyz\",\n            \"orderType\": \"CHECKOUT\",\n            \"requestId\": \"900531\",\n            \"clientId\": \"YOUR-CLIENT-ID\",\n            \"exchangeCurId\": \"brl_bz\",\n            \"exchangeAmount\": \"2.00\",\n            \"paymentMethod\": \"pix\",\n            \"errorReason\": {\n                \"errorCode\": \"9004\",\n                \"errorDesc\": \"Error occurred while the payment was processed by the payment partner\"\n            }\n        }\n    ]\n}"
      },
      {
        "id": "Ybev9LI4TwGz-n2zW-919",
        "language": "401",
        "customLabel": "",
        "code": "{\"error\":\"Client verification failed\"}"
      }
    ],
    "selectedLanguageId": "GC_lbEEV7Jo_hgFNI1cHK"
  },
  "request": {
    "pathParameters": [],
    "queryParameters": [
      {
        "name": "requestId",
        "kind": "required",
        "type": "string",
        "description": "Request Id is the unique id that was passed by your application while creating the order.",
        "children": []
      },
      {
        "name": "clientId",
        "kind": "required",
        "type": "string",
        "description": "Client Id",
        "children": []
      }
    ],
    "headerParameters": [
      {
        "name": "access-token",
        "kind": "required",
        "type": "string",
        "description": "Access token received from Access token API. You can reuse the access token across multiple API calls till it is expired.",
        "children": []
      }
    ],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Header Parameter",
    "value": "headerParameters"
  },
  "hasTryItOut": false,
  "autoGeneratedAnchorSlug": "get-order-details",
  "legacyHash": "-iBJgsqJ9XnskOxFc1df4"
}
```
:::

***