# 注文履歴の取得 ![オーダー履歴を取得する3つのステップ](https://docs.equinix.com/ja/assets/images/RetrieveOrderHistory-4dfd19548a651999578abad41e902124.png) ## 前提条件[​](#前提条件 "への直接リンク前提条件") 認証-ユーザー認証情報、クライアントID、クライアントシークレットを送信してOauth2認証を行います。認証情報を検証および認証するためにOAuth APIを呼び出す方法については、「[API認証」を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 ## 注文履歴の取得[​](#注文履歴の取得-1 "への直接リンク注文履歴の取得") オーダー履歴を取得するには、[/collocations/v2/orders/{OrderID}](https://docs.equinix.com/ja/api-catalog/ordersv2/orders/get%20order%20details.md)エンドポイントにリクエストを送信してください。`POST` サンプルcURLリクエスト: IBXデータセンターDC3およびDC4で、発注または通知にリンクされたSmart Handsオーダーの履歴リクエストが完了しました。 `smith`このリクエストが送信された日付からの日付範囲が定義されています。 ``` curl -X POST "https://api.equinix.com/v1/retrieve-orders" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "filters": {     "orderStatus": [         "SUBMITTED",         "IN_PROGRESS"     ],     "productTypes": [         "SMART_HANDS"     ],     "ibxs": [         "DC3",         "DC4"         ],         "dateRange": "PAST_YEAR"     },     "sorts": [         {             "name": "CREATED_ON",             "direction": "DESC"         }     ],     "source": [         "CONTACT_LAST_NAME"     ],     "page": {         "number": 0,         "size": 1     },     "q": "smith" } ``` リクエスト本文に含まれるパラメータは、この例に固有のものです。パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/ordersv2/orders/get%20order%20details.md)参照してください。 サンプルcURLリクエスト: IBXのDC3およびDC4でオーダーまたは通知連絡担当者にリンクされている送信済みSmart Handsオーダーのオーダー履歴リクエストが行われ、 `smith`2つの特定の日付範囲が定義されました。 ``` curl -X POST "https://api.equinix.com/v1/retrieve-orders" -H "content-type: application/json" -H "authorization: Bearer " -d '{     "filters": {     "orderStatus": [         "SUBMITTED",         "IN_PROGRESS"     ],     "productTypes": [         "SMART_HANDS"     ],     "ibxs": [         "DC3",         "DC4"      ],      "fromDate": "09/02/2019",      "toDate": "09/15/2019"     },     "sorts": [      {         "name": "CREATED_ON",         "direction": "DESC"      }     ],     "source": [         "CONTACT_LAST_NAME"     ],     "page": {         "number": 0,         "size": 1     },     "q": "smith" } ``` リクエスト本文に含まれるパラメータは、この例に固有のものです。パラメータの完全なリストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/ordersv2/orders/get%20order%20details.md)参照してください。 回答例 ``` {     "links": [         {             "rel": "self",             "href": "https://api.equinix.com/v1/orders-history/"         },         {             "rel": "next",             "href": "https://api.equinix.com/v1/orders-history/?page=1"         }     ],     "content": [         {             "orderNumber": "1-190123456789",             "createdAt": "2019-09-17T22:49:34Z",             "orderStatus": "SUBMITTED",             "orderSource": "Portal",             "account": {                 "accountName": "John Doe Corp",                 "accountNumber": "12345"             },             "uiMetaData": {                 "pricingEnforcementFlag": "false"             },             "orderingContacts": {                 "firstName": "James",                 "lastName": "Smith",                 "workPhone": "(972) 123-4567",                 "contactUCId": "234432",                 "username": "JSmith123",                 "emailAddress": "jsmith@johndoecorp.com"             },             "notificationContacts": [                 {                 "phone": "972-890-1234",                 "workPhone": "972-123-4567",                 "lastName": "Smith",                 "firstName": "James",                 "contactUCId": "234432",                 "emailAddress": "jsmith@johndoecorp.com",                 "username": "JSmith123"                 }             ],             "ibx": [                 "PAA"             ],             "type": [                 "Smart Hands"             ],             "customerReferenceNumber": "RQT12345",             "poNumbers": [                 "1-1007"             ],             "piiHoldFlag": false,             "technicalContacts": [                 {                 "firstName": "James",                 "lastName": "Smith",                 "workPhone": "(972) 123-4567",                 "contactUCId": "234432",                 "username": "JSmith123",                 "emailAddress": "jsmith@johndoecorp.com"                 }             ],             "pendingCustomerInputFlag": false,             "awaitingCustomerResponse": false,             "srNumber": "9-191234567890",             "cancellable": true,             "modifiable": true,             "links": [                 {                 "rel": "orderFullDetails",                 "href": "https://api.equinix.com/v1/orders-history/1-190123456789"                 }             ]         }     ],     "page": {         "size": 1,         "totalElements": 19,         "totalPages": 19,         "number": 0     } } ``` 応答ペイロードには、リクエスト本文で定義された構成パラメータが含まれます。使用可能なパラメータの全リストとその説明については、[APIリファレンスを](https://docs.equinix.com/ja/api-catalog/ordersv2/orders/get%20order%20details.md)参照してください。