> ## Documentation Index
> Fetch the complete documentation index at: https://docs.variable.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

Enable your PACT API in Variable in the "Variable Subdomain" section in [company settings](https://app.variable.global/company).

<Note>
  If you don't see the Variable Subdomain section, [email us](mailto:hello@variable.co), and we'll enable it for your account.
</Note>

### Requirements

There are two parts to setting up your PACT API:

1. Getting your PACT API URL
2. Sharing your Product Carbon Footprints (PCFs) with the API

### Your PACT API URL

Your PACT API URL is based on your Variable subdomain. For example, if your subdomain is `furniture-co`,
your PACT API URL is:

[https://furniture-co.variable.global/api/pact/2/footprints](https://furniture-co.variable.global/api/pact/2/footprints)

<img src="https://mintcdn.com/variable/gxymAZ01r1v-cJqJ/images/variable-subdomain-settings.png?fit=max&auto=format&n=gxymAZ01r1v-cJqJ&q=85&s=19556a02578d573e84dc97946219fc48" alt="Variable subdomain settings" style={{width: '600px', maxWidth: '100%', height: 'auto'}} className="shadow-lg" width="1346" height="718" data-path="images/variable-subdomain-settings.png" />

### API Users

By default, users must authenticate to access your PACT API. You can add API users in the same section in
your [company settings](https://app.variable.global/company). Be sure to give them the `pact:read` permission.

<img src="https://mintcdn.com/variable/gxymAZ01r1v-cJqJ/images/pact-read.png?fit=max&auto=format&n=gxymAZ01r1v-cJqJ&q=85&s=6f8420eb8f16966d97109fd903842034" alt="Permission: pact:read" style={{width: '200px', maxWidth: '100%', height: 'auto'}} className="shadow-lg" width="280" height="132" data-path="images/pact-read.png" />

### Visibility

You can also make your PACT API public to the internet by setting "Visibility" to "Public".

<img src="https://mintcdn.com/variable/gxymAZ01r1v-cJqJ/images/visibility-public.png?fit=max&auto=format&n=gxymAZ01r1v-cJqJ&q=85&s=b9d08c283b3fb7d662fee3ecc2aef4e9" alt="Variable subdomain settings: visibility" style={{width: '200px', maxWidth: '100%', height: 'auto'}} className="shadow-lg" width="362" height="116" data-path="images/visibility-public.png" />

### Sharing Footprints

Locked Product Carbon Footprint (PCF) declarations that have a sharing setting of "API" or wider, and are conformant with
the [PACT standard](https://wbcsd.github.io/data-exchange-protocol/v2), are shown in the PACT API. A footprint's `id` is
its PCF's id. A product's own sharing setting doesn't decide what the API shows.

#### PACT requirements

Details on the PACT standard and required fields can
be found [in the PACT documentation](https://wbcsd.github.io/data-exchange-protocol/v2).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.