> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.partnerpage.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.partnerpage.io/_mcp/server.

# List directory entries

GET https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/{directoryId}/entries/

Authenticated endpoint that return a paginated list of entries for an specific directory

Reference: https://docs.partnerpage.io/api-reference/entry/list-directory-entries

## Authentication

- `Authorization` header (required) (prefixed with ` Token   `) — Your API key, sent as `Authorization: Token <your API key>`

## Request

### Path parameters

- `directoryId` (string, required) — id of the directory

### Query parameters

- `entry_type` (string, optional) — type of entry to filter by
- `page` (integer, optional) — page number
- `page_size` (integer, optional) — number of results per page. Defaults to 10. Maximum 150; a larger page_size is capped to 150, not rejected
- `search` (string, optional) — value to search by
- `sort` (string, optional) — value to order by. Supported values: created, -created, modified, -modified, title, -title, tier, -tier, recommended_order, -recommended_order. Defaults to -created (newest first). Any other value returns 400
- `status` (string, optional) — status to filter by

## Response

### 200

Successful operation

- `count` (integer, required) — Entries across all pages
- `next` (string, required, nullable) — Next page
- `previous` (string, required, nullable) — Previous page
- `results` (list of ListEntriesItem, required)

## Errors

### 400 Bad Request Error

Invalid sort value

- `any`

## Types

### ListEntriesItem

All resources should return their href url

- `href` (string, required)
- `id` (string, required)
- `created` (datetime, required)
- `modified` (datetime, required)
- `headline` (string, required, nullable)
- `title` (string, required)
- `type` (string, required)
- `slug` (string, required)
- `featured` (boolean, required)
- `status` (string, required)
- `tier` (LightTierSerializerReader, required, nullable)
- `recommendedOrder` (integer, optional, nullable)
- `image` (string, optional, nullable)
- `pendingReview` (boolean, optional, nullable)

### LightTierSerializerReader

- `id` (string, required)
- `title` (string, required)
- `order` (integer, optional)

## Examples

**Response**

```json
{
  "count": 1,
  "next": "string",
  "previous": "string",
  "results": [
    {
      "href": "string",
      "id": "string",
      "created": "2024-01-15T09:30:00Z",
      "modified": "2024-01-15T09:30:00Z",
      "headline": "string",
      "title": "string",
      "type": "string",
      "slug": "string",
      "featured": true,
      "status": "string",
      "tier": {
        "id": "string",
        "title": "string",
        "order": 1
      },
      "recommendedOrder": 1,
      "image": "string",
      "pendingReview": true
    }
  ]
}
```

**SDK Code**

```python
import requests

url = "https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/directoryId/entries/"

headers = {"Authorization": "Token  <apiKey>"}

response = requests.get(url, headers=headers)

print(response.json())
```

```javascript
const url = 'https://v1.api.partnerpage.io/api/directory/private/v1alpha/directories/directoryId/entries/';
const options = {method: 'GET', headers: {Authorization: 'Token  <apiKey>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```