Get Movement Request By Id

Retrieves detailed information about a specific movement request using its unique identifier.

Authentication

This endpoint requires authentication. See Authentication for details.

Parameters

Property	Type	Required	Description
movementRequestId	string	Yes	The unique identifier of the movement request

Filters

Property	Type	Required	Description
companyCode	string	Yes	Company code for one of your managed companies

Request

Production URL: https://orchestrator.tecspal.com/
Sandbox URL: https://tecspal-orchestrator.sandbox.lexartlabs.uy/
Endpoint: GET /movement_requests/{movementRequestId}

Example Request

{
  "filters": {
    "companyCode": "DM1"
  },
  "request": "movement_requests/6f63d2b9-6ec3-467b-bb8b-38a133b92bfe",
  "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 movement request data

Movement Request Properties

Property	Type	Description
id	string	Unique identifier of the order
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 (e.g., OFFBOARDING)
status	string	Status of the request (e.g., PROCESSING)
eta	string | null	Estimated time of arrival (nullable)
sendTo	string	Destination type (e.g., 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)
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

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
id	string	movementRequestStatusHistoric unique identifier
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,
      "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": [
        {
          "id": "214594df-e068-418f-a42e-41530dd72683",
          "statusFrom": null,
          "statusTo": "PROCESSING",
          "createdAt": "2025-04-14T14:18:22.260Z"
        },
        {
          "id": "de23b865-7ac4-4a52-a923-9655450f5f47",
          "statusFrom": "PROCESSING",
          "statusTo": "COORDINATED",
          "createdAt": "2025-04-14T14:18:47.170Z"
        }
      ]
    }
  ],
  "message": "Request successful",
  "statusCode": 200
}

Error Responses

Movement Request Not Found (404)

{
  "error": "Not Found",
  "message": "Movement request not found",
  "statusCode": 404
}

Unauthorized (401)

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

Bad Request (400)

{
  "error": "Bad Request",
  "message": "Invalid movement request ID format",
  "statusCode": 400
}

Notes

• Movement requests can be either ONBOARDING (assigning to employee) or OFFBOARDING (returning to storage)
• The status field tracks the current state of the movement
• 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 requests