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

# List projects, newest first



## OpenAPI

````yaml https://api.seomator.com/openapi.json get /v1/projects
openapi: 3.1.0
info:
  title: SEOmator API
  version: 0.1.0
servers:
  - url: https://api.seomator.com
security: []
paths:
  /v1/projects:
    get:
      tags:
        - projects
      summary: List projects, newest first
      parameters:
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
          required: false
          name: limit
          in: query
        - schema:
            type: string
          required: false
          name: cursor
          in: query
        - schema:
            type: string
            enum:
              - summary
            description: >-
              summary adds each project’s tracking state and its visibility over
              the last 7 days.
          required: false
          description: >-
            summary adds each project’s tracking state and its visibility over
            the last 7 days.
          name: include
          in: query
      responses:
        '200':
          description: A page of projects
          content:
            application/json:
              schema:
                type: object
                properties:
                  projects:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        organizationId:
                          type: string
                        name:
                          type: string
                        domain:
                          type: string
                        country:
                          type: string
                        language:
                          type: string
                        description:
                          type:
                            - string
                            - 'null'
                        category:
                          type:
                            - string
                            - 'null'
                        businessType:
                          type:
                            - string
                            - 'null'
                          enum:
                            - b2b_saas
                            - consumer_software
                            - ecommerce
                            - marketplace
                            - agency_services
                            - local_business
                            - publisher_media
                            - other
                            - null
                        products:
                          type: array
                          items:
                            type: string
                        personas:
                          type: array
                          items:
                            type: string
                        topicTerms:
                          type: object
                          properties:
                            product:
                              type: array
                              items:
                                type: string
                            adjacent:
                              type: array
                              items:
                                type: string
                            exclude:
                              type: array
                              items:
                                type: string
                          required:
                            - product
                            - adjacent
                            - exclude
                          additionalProperties: {}
                        createdAt:
                          type: string
                        summary:
                          type:
                            - object
                            - 'null'
                          properties:
                            tracking:
                              type: object
                              properties:
                                status:
                                  type: string
                                  enum:
                                    - 'off'
                                    - active
                                    - paused
                                country:
                                  type: string
                                language:
                                  type: string
                                runAt:
                                  type:
                                    - string
                                    - 'null'
                                lastRunAt:
                                  type:
                                    - string
                                    - 'null'
                              required:
                                - status
                                - country
                                - language
                                - runAt
                                - lastRunAt
                              additionalProperties: {}
                            visibility:
                              type: object
                              properties:
                                named:
                                  type: number
                                answers:
                                  type: number
                              required:
                                - named
                                - answers
                              additionalProperties: {}
                            comparison:
                              type:
                                - object
                                - 'null'
                              properties:
                                status:
                                  type: string
                                  enum:
                                    - comparable
                                    - incomplete
                                    - scope_changed
                                    - no_previous
                                    - no_data
                                current:
                                  type: object
                                  properties:
                                    named:
                                      type: number
                                    answers:
                                      type: number
                                  required:
                                    - named
                                    - answers
                                  additionalProperties: {}
                                previous:
                                  type: object
                                  properties:
                                    named:
                                      type: number
                                    answers:
                                      type: number
                                  required:
                                    - named
                                    - answers
                                  additionalProperties: {}
                                excludedAssistants:
                                  type: array
                                  items:
                                    type: string
                                  default: []
                              required:
                                - status
                                - current
                                - previous
                              additionalProperties: {}
                          required:
                            - tracking
                            - visibility
                            - comparison
                          additionalProperties: {}
                      required:
                        - id
                        - organizationId
                        - name
                        - domain
                        - country
                        - language
                        - description
                        - category
                        - businessType
                        - products
                        - personas
                        - topicTerms
                        - createdAt
                        - summary
                      additionalProperties: {}
                  nextCursor:
                    type:
                      - string
                      - 'null'
                required:
                  - projects
                  - nextCursor
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKey: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - bad_request
                - unauthorized
                - insufficient_credits
                - plan_limit
                - forbidden
                - not_found
                - conflict
                - rate_limit_exceeded
                - internal_server_error
                - service_unavailable
            message:
              type: string
            requestId:
              type: string
          required:
            - code
            - message
      required:
        - error
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````

## Related topics

- [List prompts, newest first](https://docs.seomator.com/api-reference/ai-visibility/list-prompts-newest-first.md)
- [List collected answers, newest first](https://docs.seomator.com/api-reference/ai-visibility/list-collected-answers-newest-first.md)
- [List the project’s keywords](https://docs.seomator.com/api-reference/ai-visibility/list-the-project’s-keywords.md)


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