---
title: "Get an existing Redfast tenant"
method: GET
path: "/v1/tenants/{external_tenant_id}"
tags: ["Tenants"]
---

# Get an existing Redfast tenant

`GET /v1/tenants/{external_tenant_id}`

Retrieves an existing tenant from the Redfast platform.

## Path parameters

- `external_tenant_id` string, required

## Query parameters

- `partner_code` string, required

## Headers

- `rf-secret` string, required

## Response `200`

Tenant retrieved successfully

- object
  - `success` boolean
  - `external_tenant_id` string
  - `app_id` string
  - `tag_url` string, uri
  - `user_first_name` string
  - `user_last_name` string
  - `user_email` string, email
  - `app_name` string
  - `company_name` string
  - `app_domain` string
  - `test_mode` boolean

## Other responses

- `401` — Unauthorized - Shared secret is incorrect
- `404` — Not Found - Tenant not found

---

[API](https://skmtc.net/recurly/apis/custom-rendering-api.md) · [All operations](https://skmtc.net/recurly/apis/custom-rendering-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/recurly/custom-rendering-api/versions/5b447fc86155/schema)