---
title: "Apple confirmed matches"
method: GET
path: "/connected-accounts/apple-confirmed-matches"
tags: ["Connected Accounts"]
---

# Apple confirmed matches

`GET /connected-accounts/apple-confirmed-matches`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/connected-accounts/apple-confirmed-matches`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/connected-accounts/apple-confirmed-matches/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the confirmed matches between Synup locations and Apple Business listings for a connected Apple account. These are produced after a location has been connected via the Apple Business Connect OAuth flow (see Connect link for Apple). Results are paginated.

## Query parameters

- `accountId` string, required
- `connectedAccountId` string, required
- `page` integer, required

## Headers

- `Synup-Version` string, required
- `Authorization` string, required

## Response `200`

Successful response

- object
  - `data` object
    - `appleConfirmedMatches` AppleConfirmedMatches
      - `matches` AppleConfirmedMatchV2[]
        - `id` string
        - `appleBusinessId` string
        - `connectedAccountId` string
        - `connectedAccountLabel` string
        - `connectedAccountsLocationId` string
        - `lakeRecordId` string
        - `matchedOn` string, date-time
        - `synupLocationId` integer
      - `matchesCount` integer: Total number of matches.
      - `pages` integer: Total number of pages.

## Other responses

- `401`: Unauthorized - Invalid or missing API key

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)