Source: https://docs.debitura.com/collection-partners/getting-started/quickstart-accept-first-case

# Quickstart

Query your assigned cases in 2 minutes.

<a id="prerequisites"></a>

## Prerequisites

Get your API key from [Partner Portal → API Keys](https://partner.debitura.com/CollectionPartnerApiKey/Index). See [Authentication](https://docs.debitura.com/collection-partners/getting-started/authentication.md) for details.

<a id="verify-your-api-key"></a>

## Verify Your API Key

```bash
curl https://collectionpartner-api.debitura.com/me \
  -H "XApiKey: YOUR_API_KEY"
```

<a id="success-response"></a>

### Success Response

```json
{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "companyName": "Your Agency Name",
  "country": "Germany"
}
```

<a id="list-your-assigned-cases"></a>

## List Your Assigned Cases

```bash
curl "https://collectionpartner-api.debitura.com/cases?statuses=Active&pageSize=5" \
  -H "XApiKey: YOUR_API_KEY"
```

<a id="success-response-1"></a>

### Success Response

```json
{
  "page": {
    "currentPage": 1,
    "pageSize": 5,
    "totalResults": 42,
    "responseCount": 5,
    "totalPages": 9
  },
  "cases": [
    {
      "id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
      "reference": "Q8OAXF3W",
      "lifecycle": "Active",
      "grossAmount": 1500.00,
      "currency": "EUR",
      "debtor": {
        "name": "Example Company GmbH",
        "country": "Germany"
      }
    }
  ]
}
```

You've connected to the API and retrieved your cases.

See [Update Case Progress](https://docs.debitura.com/collection-partners/integration-guides/update-case-progress.md) to add notes and log activities, or [Record Payments](https://docs.debitura.com/collection-partners/integration-guides/record-payments.md) to report collected payments. For cases submitted on behalf of your clients, see [Managed Cases](https://docs.debitura.com/collection-partners/concepts/managed-cases.md). Full endpoint details are in the [API Reference](https://docs.debitura.com/api/collection-partner.md).