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

# [Domains] List all domains

> Retrieve a paginated list of all domains registered within the specified project. Each domain includes its current status, expiration date, and configuration details. Use this endpoint to monitor your domain portfolio and track registration statuses.



## OpenAPI

````yaml https://api.onetsolutions.net/schema get /v1/organizations/{organization_id}/projects/{project_id}/domains
openapi: 3.0.3
info:
  title: OnetSolutions API
  version: v1 (v1)
  description: >

    ## Overview


    The OnetSolutions API provides programmatic access to manage your cloud
    infrastructure, domains, and web hosting services.


    ## Authentication


    All API requests require authentication using one of the following methods:


    - **JWT Token**: Obtain a token via login endpoints and include it in the
    `Authorization: Bearer <token>` header

    - **API Key**: Generate an API key from your account settings and use it as
    `Authorization: Bearer sk-onetsolutions-...`


    ## Rate Limiting


    API requests are rate-limited to ensure fair usage:

    - **Standard**: 1000 requests per minute

    - **Burst**: 100 requests per second


    ## Pagination


    List endpoints return paginated results. Use `page` and `page_size` query
    parameters.


    ## Error Handling


    The API uses standard HTTP status codes:

    - `200` Success

    - `201` Created

    - `400` Bad Request

    - `401` Unauthorized

    - `403` Forbidden

    - `404` Not Found

    - `429` Too Many Requests
servers:
  - url: https://api.onetsolutions.net
    description: Production
security: []
tags:
  - name: Authentication
    description: >-
      Login, passwordless authentication, MFA, OAuth providers, and token
      management.
  - name: Organizations
    description: >-
      Organization management, members, roles, modules, audit logs, and
      notification settings.
  - name: Projects
    description: Project management, team members, and project-scoped resources.
  - name: Compute
    description: >-
      Cloud instances, volumes, snapshots, backups, VPCs, firewalls, SSH keys,
      uptime monitors, and instance tasks.
  - name: Domains
    description: >-
      Domain availability, registration, transfers, DNS zones, DNS records, and
      TLD information.
  - name: Web Hosting
    description: >-
      cPanel-based web hosting, emails, databases, subdomains, FTP accounts,
      addon domains, and SSL certificates.
paths:
  /v1/organizations/{organization_id}/projects/{project_id}/domains:
    get:
      tags:
        - Domains
      summary: '[Domains] List all domains'
      description: >-
        Retrieve a paginated list of all domains registered within the specified
        project. Each domain includes its current status, expiration date, and
        configuration details. Use this endpoint to monitor your domain
        portfolio and track registration statuses.
      operationId: list_domains
      parameters:
        - in: path
          name: organization_id
          schema:
            type: string
            format: uuid
          required: true
        - name: page
          required: false
          in: query
          description: A page number within the paginated result set.
          schema:
            type: integer
        - name: page_size
          required: false
          in: query
          description: Number of results to return per page.
          schema:
            type: integer
        - in: path
          name: project_id
          schema:
            type: string
            format: uuid
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedDomainListList'
          description: Successfully retrieved the list of domains
        '401':
          description: Authentication credentials were not provided or are invalid
        '403':
          description: You do not have permission to access this project's domains
      security:
        - BearerAuth: []
components:
  schemas:
    PaginatedDomainListList:
      type: object
      required:
        - count
        - results
      properties:
        count:
          type: integer
          example: 123
        next:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=4
        previous:
          type: string
          nullable: true
          format: uri
          example: http://api.example.org/accounts/?page=2
        results:
          type: array
          items:
            $ref: '#/components/schemas/DomainList'
    DomainList:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
        legacy_id:
          type: integer
          readOnly: true
        name:
          type: string
          readOnly: true
        status:
          enum:
            - pending
            - registering
            - active
            - expired
            - expiring_soon
            - suspended
            - transferring_in
            - transferring_out
            - pending_delete
            - deleted
            - failed
          type: string
          description: |-
            * `pending` - pending
            * `registering` - registering
            * `active` - active
            * `expired` - expired
            * `expiring_soon` - expiring soon
            * `suspended` - suspended
            * `transferring_in` - transferring in
            * `transferring_out` - transferring out
            * `pending_delete` - pending delete
            * `deleted` - deleted
            * `failed` - failed
          x-spec-enum-id: be42ed3d4dbabfa0
          readOnly: true
        registration_date:
          type: string
          format: date
          readOnly: true
          nullable: true
        expiration_date:
          type: string
          format: date
          readOnly: true
          nullable: true
        auto_renew:
          type: boolean
          readOnly: true
        whois_privacy:
          type: boolean
          readOnly: true
        is_active:
          type: boolean
          readOnly: true
        website_preview:
          allOf:
            - $ref: '#/components/schemas/WebsitePreviewList'
          readOnly: true
        created:
          type: string
          format: date-time
          readOnly: true
      required:
        - auto_renew
        - created
        - expiration_date
        - id
        - is_active
        - legacy_id
        - name
        - registration_date
        - status
        - website_preview
        - whois_privacy
    WebsitePreviewList:
      type: object
      properties:
        page_title:
          type: string
          readOnly: true
        favicon_url:
          type: string
          format: uri
          readOnly: true
        thumbnail_url:
          type: string
          format: uri
          readOnly: true
        ssl_status:
          enum:
            - valid
            - expired
            - invalid
            - none
            - unknown
          type: string
          description: |-
            * `valid` - Valid
            * `expired` - Expired
            * `invalid` - Invalid
            * `none` - No SSL
            * `unknown` - Unknown
          x-spec-enum-id: 4ae8d4d9c42dd29d
          readOnly: true
        ssl_expires_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
        http_status:
          type: integer
          readOnly: true
          nullable: true
        last_check_at:
          type: string
          format: date-time
          readOnly: true
          nullable: true
      required:
        - favicon_url
        - http_status
        - last_check_at
        - page_title
        - ssl_expires_at
        - ssl_status
        - thumbnail_url
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT or API Key
      description: >-
        Use `Authorization: Bearer <token>` header. Token can be a JWT token or
        an API key (format: `sk-onetsolutions-...`).

````