> ## Documentation index
> Fetch the complete documentation index at: https://docs.rxresu.me/llms.txt
> Ask it with GET https://docs.rxresu.me/ask?q=<keywords or question>. Short keywords rank best.
> Use these 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.

`GET /resumes`

## OpenAPI

````yaml spec.json get /resumes
openapi: 3.1.1
info:
  title: Reactive Resume
  version: 6.0.7
  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: []
paths:
  /resumes:
    get:
      operationId: listResumes
      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.
      tags:
        - Resumes
      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.
                    showInSearchEngines:
                      type: boolean
                      description: Whether search engines may list the resume's public web page. Off
                        unless the owner turns it on.
                    hideContactDetails:
                      type: boolean
                      description: Whether the public web page, its PDF and this API leave out the
                        email, phone, location, custom header fields and
                        references' phone numbers.
                    isPrimary:
                      type: boolean
                      description: Whether this is the account's primary resume, opened by its short
                        link and custom domain.
                    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
                    - showInSearchEngines
                    - hideContactDetails
                    - isPrimary
                    - 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:
    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.
    apiKey:
      type: apiKey
      name: x-api-key
      in: header
      description: The API key to authenticate requests.
````