---
title: "publications"
description: "Retrieve a list of all Publications."
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/admin-graph-ql-api/apps/queries/publications'
  md: 'https://developer.shopline.com/docs/admin-graph-ql-api/apps/queries/publications.md'
---
# publications

Retrieve a list of all Publications.

- **Required Scopes:** `read_publications`
- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Query

## Type Signature

`PublicationConnection`

## Required Permissions

* `read_publications`

An access token is required to call this API. Refer to [Authorization](https://developer.shopline.com/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md) for more information about how to obtain the token.

## Arguments

* `after`

  [String](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  Returns elements following the specified cursor. The `first` argument must also be specified when using this argument.

* `before`

  [String](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/string.md)

  Returns elements preceding the specified cursor. The `last` argument must also be specified when using this argument.

* `first`

  [Int](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/int.md)

  Returns the first n elements in the list. 

* `last`

  [Int](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/int.md)

  Returns the last n elements in the list. 

* `reverse`

  [Boolean](https://developer.shopline.com/docs/admin-graph-ql-api/common/scalars/boolean.md)

  Whether to reverse the order of the list. 
  
  ● true: reverse
  
  ● false: do not reverse
  
  Default value: false

* `catalogType`

  [CatalogType](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/enums/catalog-type.md)

  Filter Publications by catalog type.

## Returns

* `edges`

  [[PublicationEdge!]](https://developer.shopline.com/docs/admin-graph-ql-api/apps/objects/publication-edge.md)

  A list of edges.

* `nodes`

  [[Publication!]](https://developer.shopline.com/docs/admin-graph-ql-api/apps/objects/publication.md)

  A list of nodes included in PublicationEdge.

* `pageInfo`

  [PageInfo!](https://developer.shopline.com/docs/admin-graph-ql-api/common-objects/objects/page-info.md)

  Information to assist with pagination.

## Code Example

```graphql
 {
	publications(after, before, first, last, reverse, catalogType ) 
		 {
			# PublicationConnection fields
		}
}
```

## Examples

### Publications List

Publications List

**Request:**

```json
query Publications {
    publications(first: 2) {
        pageInfo {
            hasNextPage
            hasPreviousPage
            startCursor
            endCursor
        }
        nodes {
            supportsFuturePublishing
            id
            catalog {
                id
                title
                status
                ... on AppCatalog {
                    id
                    title
                    status
                    apps(first: 10) {
                        nodes {
                            appKey
                            id
                            title
                            embedded
                        }
                    }
                }
            }
        }
    }
}

```

**Response:**

```json
{
  "data": {
    "data": {
      "publications": {
        "nodes": [
          {
            "catalog": {
              "apps": {
                "nodes": [
                  {
                    "id": "gid://shopline/App/65094",
                    "title": "WhatsApp",
                    "appKey": "0bb53c89feb2c3b8fc0e4fea6991bdc37344127e",
                    "embedded": false
                  }
                ]
              },
              "id": "gid://shopline/Catalog/21230252",
              "status": "ACTIVE",
              "title": "Channel Catalog 21230251"
            },
            "id": "gid://shopline/Publication/21230251",
            "supportsFuturePublishing": false
          },
          {
            "catalog": {
              "id": "gid://shopline/Catalog/21230258",
              "status": "ACTIVE",
              "title": "Channel Catalog 21230257",
              "apps": {
                "nodes": [
                  {
                    "title": "Facebook",
                    "appKey": "111afe2f9baceb93004af92b1276582619f1db26",
                    "embedded": false,
                    "id": "gid://shopline/App/65095"
                  }
                ]
              }
            },
            "id": "gid://shopline/Publication/21230257",
            "supportsFuturePublishing": false
          }
        ],
        "pageInfo": {
          "hasPreviousPage": false,
          "startCursor": "eyJsYXN0X2lkIjoyMTIzMDI1MSwibGFzdF92YWx1ZSI6IjIxMjMwMjUxIn0=",
          "endCursor": "eyJsYXN0X2lkIjoyMTIzMDI1NywibGFzdF92YWx1ZSI6IjIxMjMwMjU3In0=",
          "hasNextPage": true
        }
      }
    }
  }
}
```

## Error Handling

For detailed information about common codes, see [Status and error codes](https://developer.shopline.com/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes).