> ## Documentation Index > Fetch the complete documentation index at: https://api.fanvue.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get list of posts > Returns a paginated list of posts created by the authenticated user. Posts are ordered by pinned status first, then by publication date (newest first). **Required scope** * `read:post` — Read posts, including post details, comments, likes, and tips. ## OpenAPI ````yaml /openapi.json get /posts openapi: 3.1.0 info: title: Fanvue API version: '0.1' servers: [] security: [] paths: /posts: get: summary: Get list of posts description: >- Returns a paginated list of posts created by the authenticated user. Posts are ordered by pinned status first, then by publication date (newest first). operationId: getPosts parameters: - $ref: '#/components/parameters/ApiVersionHeader' - schema: type: number minimum: 1 default: 1 description: Page number to retrieve (starts from 1) required: false description: Page number to retrieve (starts from 1) name: page in: query - schema: type: number minimum: 1 maximum: 50 default: 15 description: 'Number of items to return per page (1-50, default: 15)' required: false description: 'Number of items to return per page (1-50, default: 15)' name: size in: query - schema: type: string enum: - 'true' - 'false' default: 'true' description: >- Whether to include unpublished posts (drafts and scheduled posts) in the results. Defaults to true. required: false description: >- Whether to include unpublished posts (drafts and scheduled posts) in the results. Defaults to true. name: includeUnpublished in: query - schema: type: string format: date-time description: >- Only include posts created on or after this ISO 8601 datetime (e.g., 2024-10-20T00:00:00Z). required: false description: >- Only include posts created on or after this ISO 8601 datetime (e.g., 2024-10-20T00:00:00Z). name: startDate in: query - schema: type: string format: date-time description: >- Only include posts created before this ISO 8601 datetime (non-inclusive). required: false description: >- Only include posts created before this ISO 8601 datetime (non-inclusive). name: endDate in: query responses: '200': description: List of posts content: application/json: schema: type: object properties: data: type: array items: type: object properties: uuid: type: string format: uuid description: Unique identifier of the post createdAt: type: string format: date-time description: >- Date/time when the post was created (ISO 8601 format) text: type: - string - 'null' description: Text content of the post price: type: - number - 'null' description: Price in cents for paid posts mediaPreviewUuid: type: - string - 'null' format: uuid description: UUID of free preview media audience: $ref: '#/components/schemas/PostAudience' publishAt: type: - string - 'null' format: date-time description: >- Future date/time when the post will be published (ISO 8601 format) publishedAt: type: - string - 'null' format: date-time description: >- Date/time when the post was published (ISO 8601 format) expiresAt: type: - string - 'null' format: date-time description: Date/time when the post expires (ISO 8601 format) mediaUuids: type: array items: type: string format: uuid description: Array of media UUIDs attached to the post isPinned: type: boolean description: Whether the post is pinned to the top of the feed likesCount: type: number description: Number of likes the post has received commentsCount: type: number description: Number of comments on the post tips: type: object properties: count: type: number description: Number of paid tips received on this post totalGross: type: number description: Total gross amount of paid tips in cents totalNet: type: number description: >- Total net amount of paid tips in cents (after platform fees) required: - count - totalGross - totalNet description: Tips statistics for this post collections: type: array items: type: object properties: uuid: type: string format: uuid description: Unique identifier of the collection label: type: string description: Display name of the collection required: - uuid - label description: Content collections this post belongs to required: - uuid - createdAt - text - price - mediaPreviewUuid - audience - publishAt - publishedAt - expiresAt - mediaUuids - isPinned - likesCount - commentsCount - tips - collections description: Array of posts pagination: type: object properties: page: type: number description: Current page number size: type: number description: Number of records returned in this response hasMore: type: boolean description: >- Whether there are more items available on subsequent pages required: - page - size - hasMore description: Pagination information required: - data - pagination example: data: - uuid: 123e4567-e89b-12d3-a456-426614174000 createdAt: '2025-01-01T12:00:00.000Z' text: Check out my latest content! price: null audience: subscribers publishAt: null publishedAt: '2025-01-01T12:00:00.000Z' expiresAt: null mediaUuids: - a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6 mediaPreviewUuid: null isPinned: true likesCount: 42 commentsCount: 15 tips: count: 8 totalGross: 5000 totalNet: 4250 collections: - uuid: d1e2f3a4-b5c6-7890-abcd-ef1234567890 label: Behind the Scenes - uuid: 223e4567-e89b-12d3-a456-426614174001 createdAt: '2024-12-31T18:00:00.000Z' text: Happy New Year everyone! price: 500 audience: followers-and-subscribers publishAt: null publishedAt: '2024-12-31T18:00:00.000Z' expiresAt: null mediaUuids: - b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7 - c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8 mediaPreviewUuid: f1e2d3c4-b5a6-4789-8123-456789abcdef isPinned: false likesCount: 103 commentsCount: 27 tips: count: 0 totalGross: 0 totalNet: 0 collections: [] pagination: page: 1 size: 20 hasMore: false '400': $ref: '#/components/responses/ValidationErrorResponse' '401': $ref: '#/components/responses/UnauthorizedResponse' '403': $ref: '#/components/responses/UnauthorizedResponse' '410': $ref: '#/components/responses/SunsetVersionResponse' '429': $ref: '#/components/responses/RateLimitResponse' security: - BearerAuth: - read:post components: parameters: ApiVersionHeader: name: X-Fanvue-API-Version in: header required: true schema: type: string default: '2025-06-26' example: '2025-06-26' description: API version to use for the request schemas: PostAudience: type: string enum: - subscribers - followers-and-subscribers description: Audience that can view the post responses: ValidationErrorResponse: description: Request validation failed content: application/json: schema: type: object properties: errors: type: array items: type: string description: List of validation errors required: - errors UnauthorizedResponse: description: Unauthorized Response content: application/json: schema: type: object properties: error: type: string required: - error SunsetVersionResponse: description: API version no longer supported (sunset) content: application/json: schema: type: object properties: error: type: string message: type: string nextVersion: type: string required: - error - message RateLimitResponse: description: Too many requests - rate limit exceeded headers: Retry-After: description: Number of seconds to wait before retrying the request schema: type: integer X-RateLimit-Limit: description: The maximum number of requests allowed in the current window schema: type: integer X-RateLimit-Remaining: description: The number of requests remaining in the current window schema: type: integer X-RateLimit-Reset: description: The Unix timestamp (seconds) when the rate limit window resets schema: type: integer content: application/json: schema: type: object properties: error: type: string required: - error securitySchemes: BearerAuth: type: oauth2 description: >- OAuth 2.0 access token, presented as a JWT bearer token in the `Authorization` header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call. flows: authorizationCode: authorizationUrl: https://auth.fanvue.com/oauth2/auth tokenUrl: https://auth.fanvue.com/oauth2/token refreshUrl: https://auth.fanvue.com/oauth2/token scopes: read:self: >- Access your own user profile information, including basic account details and settings. read:chat: >- Read chat conversations, messages, and chat-related data. This includes viewing chat lists and message history. write:chat: >- Create new chats and send messages. This scope is required for any chat-related actions that modify data. read:experience: >- Exchange a fan's experience token for the resolved experience and the fan's identity, so an embedded fan-facing experience can render the right content. write:experience: >- Request that the creator publish or unpublish a fan-facing experience. The app mints a request token; the creator confirms and Fanvue performs the change. read:fan: Access fan-related data and information within the platform. read:post: Read posts, including post details, comments, likes, and tips. write:post: Create, edit, and manage posts and content on behalf of users. read:media: Access media files, images, videos, and other content assets. write:media: >- Upload, modify, and manage media files and content assets. Also required for vault folder management. read:creator: >- Access creator profiles, content, and creator-specific information. write:creator: Modify creator profiles, settings, and creator-specific data. read:insights: >- Access analytics, metrics, and insights data for performance tracking. read:tracking_links: >- Read tracking links and the users associated with them, including per-user tracking metadata. write:tracking_links: Create and delete tracking links. read:agency: Read agency information, including the agency's team members. write:agency: >- Manage agency team members and invites, including inviting new team members and creators. ````