---
title: "Get Magic Link"
method: GET
path: "/magic-links/{magic_link_id}"
tags: ["Auth"]
---

# Get Magic Link

`GET /magic-links/{magic_link_id}`

Get a Magic Link by its ID.

## Path parameters

- `magic_link_id` string, required

## Headers

- `x-trackstar-api-key` string, required

## Response `200`

Successful response

- MagicLinkResponseSchema
  - `magic_link` MagicLink, required
    - `id` string, required — The magic link ID
    - `url` string, required — The full Magic Link URL to share with your customer
    - `expires_at` string, required — ISO 8601 timestamp when link expires
    - `integration_type` 'wms' | 'freight' | 'cart' | 'carrier' | 'erp', required — Type of integration
    - `integration_allow_list` string[], required — Allowed integrations
    - `integration_block_list` string[], required — Blocked integrations
    - `integrations_with_endpoints` string[], required — Integrations with specific endpoints
    - `customer_id` string, nullable, required — Customer identifier

## Other responses

- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.net/trackstarhq/apis/trackstar-api.md) · [All operations](https://skmtc.net/trackstarhq/apis/trackstar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trackstarhq/trackstar-api/versions/4bc5c6e1a8bf/schema)