# Check24 Mobile Tariffs API Documentation

Returns a page of public logged-out mobile tariffs. Each result carries the tariff id and version, provider, tariff name and logo, data volume, network technology, network provider, download speed, monthly price in EUR, contract period, features, badges and provider rating. Rows that repeat across pages are removed by tariff id. Offset and limit select the page; the same values are echoed in the answer. Optional filters remove rows that do not match the requested network, minimum data volume or maximum monthly price. The network filter compares without case and accepts either the technology (for example 5g or lte) or the carrier (for example vodafone). Tariffs with no data cap satisfy any minimum data volume. Prices are numbers in EUR and ids pass through unchanged. `total` counts all upstream tariffs; `returned` is the number of rows in this page. Filters apply to this page only; `has_more` comes from the upstream page and stays true when a full page shrinks after filtering.

- **Documentation:** [https://scrappa.co/docs/check24-api/check24_mobile_list](https://scrappa.co/docs/check24-api/check24_mobile_list)
- **API group:** Check24 API
- **Endpoint:** `GET https://scrappa.co/api/check24/mobile/list`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `offset` | integer | No | Zero based row offset. Defaults to 0. |
| `limit` | integer | No | Number of rows, 1 to 50. Defaults to 10. |
| `sortBy` | string | No | popularityScore (default) or dataVolume. Data volume sorts descending with plans with no data cap first. |
| `network` | string | No | Keep only tariffs on this network technology (for example 5g or lte) or carrier (for example vodafone). Case is ignored. |
| `min_data_mb` | integer | No | Keep only tariffs with at least this data volume in MB. Tariffs with no data cap always match. |
| `max_monthly_eur` | number | No | Keep only tariffs at or below this monthly price in EUR. |

## Example response

```json
{
    "meta": {
        "duration_ms": 1200,
        "upstream_calls": 2
    },
    "limit": 10,
    "total": 482,
    "offset": 0,
    "results": [
        {
            "chips": [
                "Bestseller"
            ],
            "tariff": "Example Allnet M",
            "network": "5g",
            "currency": "EUR",
            "features": [
                "Allnet-Flat",
                "SMS-Flat"
            ],
            "logo_url": "https://cdn.example.de/logo/mobile.png",
            "provider": "Example Mobile",
            "tariff_id": "chk_mf_2026_1001",
            "speed_mbit": 300,
            "monthly_eur": 9.9,
            "is_unlimited": false,
            "tariff_rating": 4.2,
            "data_volume_mb": 20000,
            "monthly_suffix": "pro Monat",
            "provider_rating": 4.5,
            "data_volume_unit": "MB",
            "network_provider": "vodafone",
            "tariff_version_id": "7",
            "provider_rating_count": 1820,
            "contract_period_months": 24
        }
    ],
    "success": true,
    "has_more": true,
    "returned": 1
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | Returned when a required parameter is missing, a postal code is unknown or a value is out of range. No credits are charged. |
| 404 | Not Found | Returned when Check24 does not know the requested comparison. No credits are charged. |
| 502 | Unexpected Response | Returned when Check24 answers with a page this API cannot read. Failed requests are not charged. |
| 503 | Service Unavailable | Returned when Check24 could not be read. Failed requests are not charged. Try again. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
