> For the complete documentation index, see [llms.txt](https://docs.sparkloop.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sparkloop.app/api-v3/endpoints/publications.md).

# Publications

## Publications

A **Publication** is the central resource on your account — the unit most other v3 resources hang off (recommendations, signup flow, and partner program are all scoped to a publication). Use this resource to list your account's publications, or fetch a single one by UUID.

### List publications

<mark style="color:blue;">`GET`</mark> `https://api.sparkloop.app/v3/publications`

Paginated — accepts `page` and `per_page`. Newest first.

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

```json
{
  "publications": [
    <Publication Object>
  ],
  "meta": {
    "per_page": 50,
    "page": 1,
    "total_pages": 1,
    "total_publications": 3
  }
}
```

{% endtab %}
{% endtabs %}

### Get publication

<mark style="color:blue;">`GET`</mark> `https://api.sparkloop.app/v3/publications/:uuid`

**Path Parameters**

| Name                                   | Type   | Description             |
| -------------------------------------- | ------ | ----------------------- |
| uuid<mark style="color:red;">\*</mark> | String | The publication's UUID. |

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

```json
{
  "publication": <Publication Object>
}
```

{% endtab %}

{% tab title="404: Not Found" %}

```json
{
  "error": "Resource not found."
}
```

{% endtab %}
{% endtabs %}