GET /entries | FlowCMS API Documentation

Query Parameters

Parameter	Type	Description
`collection` Required	`string`	Collection slug to fetch entries from (e.g., `blog_posts`, `products`)
`page`	`integer`	Page number for pagination. Defaults to `1`
`per_page`	`integer`	Number of entries per page. Min: 1, Max: 100. Defaults to `20`
`sort`	`string`	Field to sort by. Prefix with `-` for descending (e.g., `-created_at`)
`filter`	`string`	JSON-encoded filter object. Supports operators: `$eq`, `$gt`, `$in`, `$contains`
`fields`	`string`	Comma-separated list of fields to include in response. Reduces payload size.
`status`	`string`	Filter by entry status: `draft`, `published`, `archived`

Code Examples

                        
                        curl https://api.flowcms.io/v1/entries \\
  -H "Authorization: Bearer $FLOWCMS_API_KEY" \\
  -H "Content-Type: application/json" \\
  -G \\
  --data-urlencode "collection=blog_posts" \\
  --data-urlencode "page=1" \\
  --data-urlencode "per_page=10" \\
  --data-urlencode "sort=-published_at" \\
  --data-urlencode "status=published"
                    

                        
                        import { FlowCMS } from '@flowcms/sdk';

const cms = new FlowCMS({ apiKey: process.env.FLOWCMS_API_KEY });

async function getEntries() {
  const response = await cms.entries.list({
    collection: 'blog_posts',
    page: 1,
    perPage: 10,
    sort: '-published_at',
    status: 'published'
  });

  console.log(response.data.entries);
}

getEntries();
                    

                        
                        import flowcms

client = flowcms.Client(api_key="$FLOWCMS_API_KEY")

response = client.entries.list(
    collection="blog_posts",
    page=1,
    per_page=10,
    sort="-published_at",
    status="published"
)

for entry in response["entries"]:
    print(entry["title"])
                    

                        
                        use FlowCMS\Client;

$client = new Client(getenv('FLOWCMS_API_KEY'));

$response = $client->entries->list([
    'collection' => 'blog_posts',
    'page' => 1,
    'per_page' => 10,
    'sort' => '-published_at',
    'status' => 'published'
]);

foreach ($response['entries'] as $entry) {
    echo $entry['title'] . "\n";
}
                    

Example Response

200 OK application/json

124ms • 2.4 KB

{
  "meta": {
    "current_page": 1,
    "per_page": 10,
    "total_entries": 47,
    "total_pages": 5,
    "next_page": "https://api.flowcms.io/v1/entries?collection=blog_posts&page=2"
  },
  "entries": [
    {
      "id": "ent_8xK29mQp1L",
      "title": "Building Scalable Content Pipelines",
      "slug": "building-scalable-content-pipelines",
      "status": "published",
      "authors": ["auth_92jK1", "auth_m3nP7"],
      "published_at": "2024-11-15T09:30:00Z",
      "created_at": "2024-11-10T14:22:11Z",
      "updated_at": "2024-11-15T09:30:05Z",
      "meta": {
        "seo_title": "Scalable Content Pipelines | FlowCMS Guide",
        "tags": ["architecture", "cms", "api"]
      }
    },
    {
      "id": "ent_7yR41nWs2M",
      "title": "Headless CMS Best Practices for 2025",
      "slug": "headless-cms-best-practices-2025",
      "status": "published",
      "authors": ["auth_92jK1"],
      "published_at": "2024-11-12T11:00:00Z",
      "created_at": "2024-11-05T08:15:30Z",
      "updated_at": "2024-11-12T11:00:12Z",
      "meta": {
        "seo_title": "Headless CMS Best Practices",
        "tags": ["guide", "headless"]
      }
    }
  ]
}

Notes & Best Practices

Always use fields to limit payload size when you only need specific attributes.
Pagination is cursor-safe. Use meta.next_page for reliable sequential fetching.
Rate limits: 120 requests/minute for standard keys, 600 for enterprise. Check X-RateLimit-Remaining headers.
Full-text search across text fields is supported via the q parameter (available in v1.2+).
All timestamps are ISO 8601 UTC. Timezone conversion should be handled client-side.