# Recuperar el historial de pedidos ![Tres pasos para recuperar el historial de pedidos](https://docs.equinix.com/es/assets/images/RetrieveOrderHistory-4dfd19548a651999578abad41e902124.png) ## Requisitos previos[​](#requisitos-previos "Enlace directo a Requisitos previos") Autenticar: Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte [Autenticación de API](https://docs.equinix.com/es/equinix-api/api-authentication.md) para obtener instrucciones sobre cómo llamar al API de OAuth para validar y autenticar sus credenciales. ## Recuperación del historial de pedidos[​](#recuperación-del-historial-de-pedidos "Enlace directo a Recuperación del historial de pedidos") Para recuperar su historial de pedidos, envíe una `POST` solicitud al punto final[/colocations/v2/orders/{orderId}](https://docs.equinix.com/es/api-catalog/ordersv2/orders/get%20order%20details.md). Ejemplo de solicitud cURL: Se ha realizado una solicitud de historial de pedidos para los pedidos enviados de Smart Hands vinculados a la persona de contacto del pedido o de notificación con apellidos `smith`en los centros de datos IBX DC3 y DC4, y se ha definido el intervalo de fechas a partir de la fecha en que se envía esta solicitud. ``` 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" } ``` Los parámetros incluidos en el cuerpo de la solicitud son específicos de este ejemplo. Para obtener una lista completa de parámetros y sus descripciones, consulte la [referencia de API](https://docs.equinix.com/es/api-catalog/ordersv2/orders/get%20order%20details.md) . Ejemplo de solicitud cURL: Se ha realizado una solicitud de historial de pedidos para los pedidos enviados de Smart Hands vinculados a una persona de contacto de pedidos o notificaciones con apellidos `smith`en IBX DC3 y DC4 y se ha definido un intervalo de fechas entre dos fechas específicas. ``` 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" } ``` Los parámetros incluidos en el cuerpo de la solicitud son específicos de este ejemplo. Para obtener una lista completa de parámetros y sus descripciones, consulte la [referencia de API](https://docs.equinix.com/es/api-catalog/ordersv2/orders/get%20order%20details.md) . Respuesta de muestra: ``` {     "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     } } ``` La carga útil de respuesta incluye parámetros de configuración definidos en el cuerpo de la solicitud. Para obtener una lista completa de los posibles parámetros y sus descripciones, consulte la [Referencia de API](https://docs.equinix.com/es/api-catalog/ordersv2/orders/get%20order%20details.md) .