Get All Movement Requests

Retrieves a list of hardware movement requests for a specific company.

Authentication

This endpoint requires authentication. See Authentication for details.

Filters

Property	Type	Required	Description
companyCode	string	Yes	Company code for one of your managed companies
type	string	No	Filter by movement type (ONBOARDING, OFFBOARDING, OFF_ON)

Request

Production URL: https://orchestrator.tecspal.com/
Sandbox URL: https://orchestrator-dev.tecspal.com/
Endpoint: GET /movement_requests

Example Request

{
  "filters": {
    "companyCode": "DM1",
    "type": "ONBOARDING"
  },
  "request": "movement_requests",
  "vendor": "tecspal",
  "verb": "GET"
}

Response Schema

Property	Type	Description
statusCode	number	HTTP status code of the response
message	string	Description of the response status
envelop	array	Array containing the list of movement requests

Movement Request Properties

Property	Type	Description
id	string	Unique identifier of the movement request
movementRequestNumber	number	Request number
createdAt	string	ISO timestamp when the request was created
updatedAt	string	ISO timestamp when the request was last updated
type	string	Type of request (ONBOARDING, OFFBOARDING, OFF_ON)
status	string	Status of the request (e.g., PROCESSING, COORDINATED, DONE)
eta	string | null	Estimated time of arrival (nullable)
sendTo	string	Destination type (EMPLOYEE, STORAGE)
handledBy	string	The team or person handling the request
expectedDate	string | null	Expected date (nullable)
factoryReset	boolean	Whether a factory reset is required
trackingLink	string | null	Link for tracking (nullable)
trackingCode	string | null	Code for tracking (nullable)
dateCompleted	string | null	Date when the request was completed (nullable)
requesterEmail	string | null	Email of the requester
apiClientRequesterName	string | null	Name of the API client requester
toEmployee	object | null	Details of the employee the request is for (nullable)
fromEmployee	object | null	Employee initiating the request
storage	object	Storage details
companyName	string	Name of the company
hardwares	array	List of hardware items related to the request
movementRequestStatusHistoric	array	History of the status changes of the request

fromEmployee / toEmployee Properties

Property	Type	Description
id	string	Unique identifier of the employee
firstName	string	First name of the employee
lastName	string	Last name of the employee
countryCode	string	Country code of the employee
email	string	Email of the employee
address	string	Address of the employee
addressExtraInfo	string | null	Extra address information
postCode	string	Postal code of the employee

storage Properties

Property	Type	Description
id	string	Unique identifier of the storage
countryCode	string	Country code of the storage

hardwares Properties

Property	Type	Description
id	string	Hardware unique identifier
description	string	Description of the hardware
serialNumber	string	Serial number of the hardware
brand	string	Brand of the hardware
name	string	Name of the hardware
ram	string	RAM configuration (if applicable)
diskSpace	string	Disk space (if applicable)
displaySize	string	Display size (if applicable)
processor	string	Processor type (if applicable)
image	string	URL of the hardware image (if available)

movementRequestStatusHistoric Properties

Property	Type	Description
createdAt	string	ISO timestamp when the status change occurred
statusTo	string	New status after the change
statusFrom	string | null	Previous status before the change (nullable)

Example Response

{
  "envelop": [
    {
      "id": "6f63d2b9-6ec3-467b-bb8b-38a133b92bfe",
      "movementRequestNumber": 50001005,
      "createdAt": "2025-04-14T14:18:22.234Z",
      "updatedAt": "2025-04-14T14:18:47.159Z",
      "type": "ONBOARDING",
      "status": "COORDINATED",
      "eta": "2025-05-03",
      "sendTo": "EMPLOYEE",
      "handledBy": "TECSPAL",
      "expectedDate": null,
      "factoryReset": null,
      "trackingLink": null,
      "trackingCode": null,
      "dateCompleted": null,
      "requesterEmail": "superadmin@tecspal.com",
      "apiClientRequesterName": null,
      "toEmployee": {
        "id": "0a86b6c2-7373-42fa-a44a-70857cef0f90",
        "firstName": "John",
        "lastName": "Doe",
        "countryCode": "UY",
        "email": "john_doe@email.com",
        "address": "Plaza Independencia 848, Montevidéu, Uruguai",
        "addressExtraInfo": null,
        "postCode": "11100"
      },
      "fromEmployee": null,
      "storage": {
        "id": "f5d253a3-e494-4614-9c8e-001789def712",
        "countryCode": "UY"
      },
      "companyName": "Larian Studios",
      "hardwares": [
        {
          "id": "bebe97aa-8768-47df-93ab-79a818ab04be",
          "description": "New",
          "serialNumber": "1252552",
          "brand": "Apple",
          "name": "MacBook Pro",
          "ram": "16GB",
          "diskSpace": "512GB",
          "displaySize": "16 inch",
          "processor": "M1 Pro",
          "image": "https://a-us.storyblok.com/f/1001855/789x500/82ee51ba4d/macbook-pro-16.png"
        }
      ],
      "movementRequestStatusHistoric": [
        {
          "createdAt": "2025-04-14T14:18:22.260Z",
          "statusTo": "PROCESSING",
          "statusFrom": null
        },
        {
          "createdAt": "2025-04-14T14:18:47.170Z",
          "statusTo": "COORDINATED",
          "statusFrom": "PROCESSING"
        }
      ]
    }
  ],
  "message": "Request successful",
  "statusCode": 200
}

Error Responses

Bad Request (400)

{
  "error": "Bad Request",
  "message": "Invalid Company code",
  "statusCode": 400
}

Unauthorized (401)

{
  "error": "Unauthorized",
  "message": "Unauthorized access",
  "statusCode": 401
}

Notes

• Results are filtered by companyCode (required) and optional type
• Invalid type values return HTTP 400
• Movement requests can be filtered by type: ONBOARDING, OFFBOARDING, or OFF_ON
• The response includes both completed and pending requests
• Status history is tracked in movementRequestStatusHistoric
• When handledBy is TECSPAL, the movement is managed by Tecspal's logistics team
• When handledBy is COMPANY, the company manages the movement internally
• The factoryReset flag is only relevant for offboarding to storage