> For the complete documentation index, see [llms.txt](https://developers.copyfactory.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.copyfactory.io/api/premises/get-a-premise.md).

# Get a premise

## Get a premise object by ID

<mark style="color:blue;">`GET`</mark> `https://app.copyfactory.io/api/v2/premises/get/`

Will get the sentence premise object by ID.

#### Query Parameters

| Name                                          | Type | Description                          |
| --------------------------------------------- | ---- | ------------------------------------ |
| premise\_id<mark style="color:red;">\*</mark> | int  | The premise Id you wish to retrieve. |

#### Headers

| Name                                            | Type   | Description              |
| ----------------------------------------------- | ------ | ------------------------ |
| Authorization<mark style="color:red;">\*</mark> | string | Your Copyfactory API key |

{% tabs %}
{% tab title="200: OK Success" %}

```javascript
{
    "data": {
        "id": 19,
        "order": 0,
        "is_active": true,
        "required_variables": [
            "person_description"
        ],
        "sentence_premise_name": "Contact",
        "profile_name": "Copyfactory"
    }
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Shell" %}

```
curl --location --request GET 'https://app.copyfactory.io/api/v2/premises/get?premise_id=PREMISE-ID/' \
--header 'Authorization: API-KEY'
```

{% endtab %}

{% tab title="Python" %}

```
import requests

url = "https://app.copyfactory.io/api/v2/premises/get/"

params = (('premise_id', PREMISE-ID),)

headers = {
  'Authorization': 'API-KEY'
}

response = requests.request("GET", url, headers=headers, params=params)

print(response.text)
```

{% endtab %}
{% endtabs %}