---
title: "Get Alternatives Endpoint"
method: GET
path: "/v1/alternatives/{service_slug}"
tags: ["alternatives"]
---

# Get Alternatives Endpoint

`GET /v1/alternatives/{service_slug}`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/alternatives/{service_slug}`
- Auth: none declared. Required headers: `X-API-Key`

Find alternatives to a subscription service with price comparison.

## Path parameters

- `service_slug` string, required: Service slug — get slugs from `GET /v1/services`

## Query parameters

- `country` string: ISO country code: AU, US, UK, CA, NZ
- `sort` string: Sort order: price_asc, price_desc, or overlap (feature similarity)
- `limit` integer: Max number of alternatives to return

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)