> ## Documentation Index > Fetch the complete documentation index at: https://docs.zapnito.com/llms.txt > Use this file to discover all available pages before exploring further. # List posts > Returns a paginated list of posts, optionally filtered by search term. Related records (rooms, channels, badges, tags, topics and contributors) are returned alongside the posts and referenced from each post by id ## OpenAPI ````yaml https://api.zapnito.com/api/docs/v1/swagger.json get /api/v1/posts openapi: 3.0.1 info: title: API V1 version: v1 description: Zapnito API Documentation servers: - url: https://{host} description: Your community domain variables: host: default: your-community.com description: Your community domain, for example your-community.com security: [] tags: - name: Health Check description: Check that the API is reachable and that your API key is valid - name: Identity description: Find out which community your API key belongs to - name: Users description: >- Look up the people in your community, update their profile and choose which notifications they receive - name: Organisations description: >- Create and update the organisations in your community and manage who belongs to them - name: Groups description: Create groups and manage which users belong to them - name: Invitations description: Invite people to join your community - name: Posts description: Create, read and update posts on behalf of your community members - name: Contents description: >- Read the published content of your community and publish, schedule or unpublish it - name: Channels description: List the channels in your community and the content published in each - name: Rooms description: Create and read the rooms where your community members meet - name: Tags description: Create tags and apply them to content - name: Badges description: Create badges and award them to content or to users - name: Custom Fields description: Read the custom profile fields your community asks its members to fill in - name: Third-Party Resources description: >- Link to resources hosted outside your community so they appear alongside your content - name: Rest Hooks description: >- Subscribe a URL to events in your community, so you are told when they happen paths: /api/v1/posts: get: tags: - Posts summary: List posts description: >- Returns a paginated list of posts, optionally filtered by search term. Related records (rooms, channels, badges, tags, topics and contributors) are returned alongside the posts and referenced from each post by id operationId: listPosts parameters: - name: page in: query required: false description: 'Page number (default: 1)' schema: type: integer - name: per_page in: query required: false description: 'Number of items per page (default: 20)' schema: type: integer - name: query in: query required: false description: Search term used to filter results schema: type: string responses: '200': description: A page of posts, with the records they refer to content: application/json: schema: type: object properties: posts: type: array items: $ref: '#/components/schemas/Post' rooms: type: array items: type: object uncategorised_rooms: type: array items: type: object room_categories: type: array items: type: object channels: type: array items: type: object badges: type: array items: type: object tags: type: array items: type: object topics: type: array items: type: object content_contributors: type: array items: type: object content_share_recipients: type: array items: type: object posters: type: array items: type: object required: - posts '401': description: >- The API key is missing or invalid. The response body is the text `HTTP Token: Access denied.` security: - tokenAuth: [] components: schemas: Post: type: object properties: id: type: integer example: 1 type: type: string example: Post status: type: string example: Complete title: type: string example: How we improved onboarding introduction: type: string nullable: true example: A short summary of the post content: type: string nullable: true example: The full body of the post thumbnail: type: string nullable: true example: https://example.com/thumbnail.png author_email: type: string format: email example: jane@example.com canonical_url: type: string example: https://example.com/posts/how-we-improved-onboarding internal_url: type: string example: https://example.com/posts/how-we-improved-onboarding doi: type: string nullable: true example: https://doi.org/10.1000/example published_at: type: string nullable: true format: date-time example: '2024-01-01T00:00:00Z' description: When the post was published. Null for a draft or scheduled post scheduled_at: type: string nullable: true format: date-time example: '2024-01-01T00:00:00Z' description: When the post will be published. Null unless it is scheduled created_at: type: string format: date-time example: '2024-01-01T00:00:00Z' seo_title: type: string nullable: true example: How we improved onboarding seo_description: type: string nullable: true example: A short summary of the post is_draft: type: boolean example: false description: Whether the post is a draft is_scheduled: type: boolean example: false description: Whether the post is scheduled to be published is_published: type: boolean example: true description: Whether the post has been published comments_enabled: type: boolean example: true downloads_enabled: type: boolean example: true premium: type: boolean example: false required: - id - type - status - title - content - author_email - canonical_url - created_at securitySchemes: tokenAuth: type: apiKey name: Authorization in: header description: >- API authentication using your community API secret. The value below is sent as the Authorization header verbatim, so paste the whole header value including the prefix: Token token= x-default: Token token= ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.