---
title: "Retrieve a Group of Links by Reference IDs"
method: POST
path: "/api/v1/links/batch"
tags: ["Links"]
---

# Retrieve a Group of Links by Reference IDs

`POST /api/v1/links/batch`

Get details for multiple links by providing an array of reference IDs (1-100 items). Only returns links that belong to the authenticated merchant.

## Request body

- object
  - `referenceIds` string[], required — Array of your reference IDs to retrieve. Minimum 1, maximum 100 items per request.

## Response `200`

Batch retrieval successful

- object
  - `data` object[]
    - `referenceId` string
    - `id` string
    - `total` string
    - `currency` string
    - `type` string
    - `paymentMethod` string, nullable
    - `status` string
    - `completedAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `url` string, uri
    - `webhookUrl` string, uri
    - `redirectionUrl` string, uri
    - `linkExpiresIn` string — Duration until the payment link expires
  - `message` string
  - `totalRequested` integer — Total number of reference IDs requested
  - `totalFound` integer — Total number of links found

## Other responses

- `422` — Invalid request body

---

[API](https://skmtc.dev/thewayl/apis/wayl-api.md) · [All operations](https://skmtc.dev/thewayl/apis/wayl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thewayl/wayl-api/revisions/ee660efc8daf/schema)