> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rxresu.me/llms.txt
> Use this file to discover all available pages before exploring further.

# List all resumes

> Returns a list of all resumes belonging to the authenticated user. Results can be filtered by tags and sorted by last updated date, creation date, or name. Resume data is not included in the response for performance; use the get endpoint to fetch full resume data. Requires authentication.



## OpenAPI

````yaml /spec.json get /resumes
openapi: 3.1.1
info:
  title: Reactive Resume
  version: 6.0.3
  description: >-
    Reactive Resume API. Mutations do not support Idempotency-Key. Do not
    automatically retry POST, PUT, PATCH or DELETE requests after a timeout:
    first read the resource to determine whether the operation succeeded.
    Existing enum values and response shapes are retained for compatibility.
  license:
    name: MIT
    url: https://github.com/reactive-resume/reactive-resume/blob/main/LICENSE
  contact:
    name: Amruth Pillai
    email: amruth@rxresu.me
    url: https://amruthpillai.com
servers:
  - url: https://rxresu.me/api/openapi
security:
  - apiKey: []
  - bearerAuth: []
  - cookieAuth: []
externalDocs:
  url: https://docs.rxresu.me
  description: Reactive Resume Documentation
paths:
  /resumes:
    get:
      tags:
        - Resumes
      summary: List all resumes
      description: >-
        Returns a list of all resumes belonging to the authenticated user.
        Results can be filtered by tags and sorted by last updated date,
        creation date, or name. Resume data is not included in the response for
        performance; use the get endpoint to fetch full resume data. Requires
        authentication.
      operationId: listResumes
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            description: >-
              Maximum results (1–100). Omit both pagination fields for the
              legacy complete list.
          allowEmptyValue: true
          allowReserved: true
        - name: offset
          in: query
          schema:
            type: integer
            minimum: 0
            maximum: 9007199254740991
            description: >-
              Zero-based offset. Defaults to 0; limit defaults to 20 when only
              offset is given.
          allowEmptyValue: true
          allowReserved: true
        - name: tags
          in: query
          schema:
            anyOf:
              - type: string
              - type: array
                items:
                  type: string
            default: []
          allowEmptyValue: true
          allowReserved: true
        - name: sort
          in: query
          schema:
            enum:
              - lastUpdatedAt
              - createdAt
              - name
            type: string
            default: lastUpdatedAt
          allowEmptyValue: true
          allowReserved: true
      responses:
        '200':
          description: A list of resumes with their metadata (without full resume data).
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: The ID of the resume.
                    name:
                      type: string
                      minLength: 1
                      description: The name of the resume.
                    slug:
                      type: string
                      minLength: 1
                      description: The slug of the resume.
                    tags:
                      type: array
                      items:
                        type: string
                      description: The tags of the resume.
                    isPublic:
                      type: boolean
                      description: Whether the resume is public.
                    showDownloadButtons:
                      type: boolean
                      description: >-
                        Whether download buttons are shown on the public resume
                        page.
                    isLocked:
                      type: boolean
                      description: Whether the resume is locked.
                    createdAt:
                      type: string
                      format: date-time
                      x-native-type: date
                      description: The date and time the resume was created.
                    updatedAt:
                      type: string
                      format: date-time
                      x-native-type: date
                      description: The date and time the resume was last updated.
                  required:
                    - id
                    - name
                    - slug
                    - tags
                    - isPublic
                    - showDownloadButtons
                    - isLocked
                    - createdAt
                    - updatedAt
          headers:
            X-Total-Count:
              description: Total matching results before pagination.
              schema:
                type: integer
            X-Limit:
              description: Page size, when pagination is requested.
              schema:
                type: integer
            X-Offset:
              description: Zero-based offset, when pagination is requested.
              schema:
                type: integer
        default:
          description: >-
            Structured API error. See status and code; do not branch on message
            text.
          content:
            application/json:
              schema:
                type: object
                required:
                  - defined
                  - code
                  - status
                  - message
                properties:
                  defined:
                    type: boolean
                  code:
                    type: string
                  status:
                    type: integer
                  message:
                    type: string
                  data: {}
      security:
        - apiKey: []
        - bearerAuth: []
        - cookieAuth: []
      x-codeSamples:
        - lang: bash
          label: cURL
          source: >-
            curl "https://rxresu.me/api/openapi/resumes" --header "x-api-key:
            <api-key>"
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header
      description: The API key to authenticate requests.
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: An OAuth access token issued by this instance for its API/MCP resource.
    cookieAuth:
      type: apiKey
      in: cookie
      name: better-auth.session_token
      description: >-
        Browser session (secure deployments use the __Secure- prefix). Cookie
        requests must originate from this instance.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.