---
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}`

## Request

- Base URL: `https://partner.redfast.com`
- URL: `https://partner.redfast.com/v1/tenants/{external_tenant_id}`
- Auth: none declared. Required headers: `rf-secret`

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.dev/recurly/apis/redfast-tenant-api.md) - [All operations](https://skmtc.dev/recurly/apis/redfast-tenant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/recurly/apis/redfast-tenant-api/revisions/d4f8b2c28ef1?raw)