---
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`

## Request

- Base URL: `https://collectionpartner-api.debitura.com`
- URL: `https://collectionpartner-api.debitura.com/cases/by-partner-reference`
- Auth: API key in header `XApiKey`

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

## Changes

- **2026-10-01** `460a861d7d9b`: 3 info
  - response property `additionalProperties/collectionPartner/surveyCadenceMode` deprecated (media type: text/plain)
  - response property `additionalProperties/collectionPartner/surveyCadenceMode` deprecated (media type: application/json)
  - response property `additionalProperties/collectionPartner/surveyCadenceMode` deprecated (media type: text/json)

[Operation history](https://skmtc.dev/debitura/apis/debitura-collection-partner-api/changes/cases/by-partner-reference/get.md)

---

[API](https://skmtc.dev/debitura/apis/debitura-collection-partner-api.md) - [All operations](https://skmtc.dev/debitura/apis/debitura-collection-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/debitura/apis/debitura-collection-partner-api/revisions/a7cf0ff022b6?raw)