---
title: "🆕 Get Place Plans"
method: GET
path: "/partner/plans"
tags: ["Partner::Plans"]
---

# 🆕 Get Place Plans

`GET /partner/plans`

This endpoint is an alternative way of obtaining a place's active plans in TotalPass instead of using the Authentication endpoint. However, the partner needs to provide the token to use it, which is generated by the Authentication endpoint.
Unlike the Authentication endpoint, the partner can provide an `id` to filter the plans.
  
  The `id` parameter can be:
     - The plan's `code`: previously obtained from the Authentication endpoint's response;
     - The plan's `externalReference`: this is specifically for internal use, external partners won't have access to this parameter, therefore it shouldn't be openly used.

**If no `id` is provided, all active plans associated with the place will be returned as a response to this endpoint.**

## Query parameters

- `id` string

## Headers

- `Authorization` string, required

## Response `200`

OK

- object

## Other responses

- `400` — No plan found with code or externalReference
- `401` — Unauthorized

---

[API](https://skmtc.net/totalpass/apis/token-use.md) · [All operations](https://skmtc.net/totalpass/apis/token-use/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/totalpass/token-use/versions/bc65b4950c7e/schema)