---
title: "Batch lookup of cases by the collection partner's own reference IDs."
method: GET
path: "/cases/by-partner-reference"
tags: ["Cases"]
---

# Batch lookup of cases by the collection partner's own reference IDs.

`GET /cases/by-partner-reference`

Returns a dictionary mapping each partner reference to its corresponding case details.

**Use Case:**
Use this endpoint to look up multiple cases at once using your own internal reference IDs. This is more efficient than making individual calls for each reference.

**Parameters:**
- references (required) - Comma-separated list of partner reference strings (max 100)

**Matching:**
Exact string match only. References not found or not assigned to you are omitted from the response (no error).

**Response:**
A dictionary where keys are the partner reference strings and values are the case details. Missing references are silently omitted.

## Query parameters

- `references` string

## Response `200`

Dictionary of reference to case

- object

## Other responses

- `400` — References parameter missing, empty, or exceeds maximum

---

[API](https://skmtc.net/debitura/apis/debitura-collection-partner-api.md) · [All operations](https://skmtc.net/debitura/apis/debitura-collection-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debitura/debitura-collection-partner-api/revisions/db09d0fd5c94/schema)