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

# Get Lines

> Fetch a list of all lines.



## OpenAPI

````yaml /openapi.json get /v1/lines/all
openapi: 3.1.0
info:
  version: 1.0.0
  title: CCCAMBOX Reseller API
  description: >-
    CCCambox Reseller API provides programmatic access to manage IPTV
    subscriptions and line management. Use this API to automate operations like
    creating new lines, managing packages, handling credits. Includes endpoints
    for subscriber management, package configuration, and line monitoring. Built
    for resellers to efficiently scale their IPTV business operations.
servers: []
security: []
paths:
  /v1/lines/all:
    get:
      tags:
        - Line Management
      summary: Get Lines
      description: Fetch a list of all lines.
      parameters:
        - schema:
            type:
              - integer
              - 'null'
            minimum: 0
            default: 0
            description: >-
              The offset for the returned lines. Should be a non-negative
              integer.
            example: 0
          required: false
          description: The offset for the returned lines. Should be a non-negative integer.
          name: offset
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
            description: >-
              The number of lines to return. Should be an integer between 1 and
              100.
            example: 20
          required: false
          description: >-
            The number of lines to return. Should be an integer between 1 and
            100.
          name: limit
          in: query
        - schema:
            type: string
            enum:
              - all
              - active
              - suspended
              - expiring
            default: all
            description: >-
              Status of the returned lines. Possible values: 'all', 'active',
              'suspended', 'expiring'.
          required: false
          description: >-
            Status of the returned lines. Possible values: 'all', 'active',
            'suspended', 'expiring'.
          name: status
          in: query
        - schema:
            type: string
            enum:
              - all
              - premium
              - trial
            default: all
            description: >-
              Type of the line to return. Possible values: 'all', 'premium',
              'trial'.
          required: false
          description: >-
            Type of the line to return. Possible values: 'all', 'premium',
            'trial'.
          name: type
          in: query
        - schema:
            type: string
            description: Search lines by partial username or line ID.
            example: demo
          required: false
          description: Search lines by partial username or line ID.
          name: search
          in: query
        - schema:
            type: string
            enum:
              - id
              - username
              - enabled
              - exp_date
            default: id
            description: >-
              Field to sort lines by. Possible values: 'id', 'username',
              'enabled', 'exp_date'.
          required: false
          description: >-
            Field to sort lines by. Possible values: 'id', 'username',
            'enabled', 'exp_date'.
          name: orderBy
          in: query
        - schema:
            type: string
            enum:
              - asc
              - desc
            default: asc
            description: 'Type of sort. Possible values: ''asc'', ''desc''.'
          required: false
          description: 'Type of sort. Possible values: ''asc'', ''desc''.'
          name: orderType
          in: query
      responses:
        '200':
          description: Returns a list of lines.
          content:
            application/json:
              schema:
                type: object
                properties:
                  offset:
                    type: integer
                    minimum: 0
                    description: The offset used for the current response.
                    example: 0
                  limit:
                    type: integer
                    minimum: 1
                    description: The requested page size for the current response.
                    example: 20
                  totalHits:
                    type: number
                    description: >-
                      The total number of lines available. (Helpfull for
                      pagination)
                  totalReturns:
                    type: number
                    description: The number of lines returned in the current response.
                  hasNextPage:
                    type: boolean
                    description: >-
                      Whether another page of results is available after this
                      one.
                    example: true
                  hasPreviousPage:
                    type: boolean
                    description: Whether a previous page of results exists before this one.
                    example: false
                  nextOffset:
                    type:
                      - integer
                      - 'null'
                    minimum: 0
                    description: >-
                      The offset to request the next page, or null when there is
                      no next page.
                    example: 20
                  previousOffset:
                    type:
                      - integer
                      - 'null'
                    minimum: 0
                    description: >-
                      The offset to request the previous page, or null when
                      there is no previous page.
                    example: null
                  lines:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        hostname:
                          type:
                            - string
                            - 'null'
                        username:
                          type: string
                        password:
                          type: string
                        label:
                          type: string
                        enabled:
                          type: boolean
                        connections:
                          type: number
                        is_trial:
                          type: boolean
                        exp_date:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          example: '2026-05-15T15:13:02.991Z'
                          description: Date of expiration of the line.
                        start_date:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          example: '2026-05-15T15:13:02.992Z'
                          description: >-
                            Starting date of the line (Creation date or
                            Extension date if the line has been extended).
                        created_at:
                          type:
                            - string
                            - 'null'
                          format: date-time
                          example: '2026-05-15T15:13:02.992Z'
                          description: Initial creation date of the line.
                      required:
                        - id
                        - hostname
                        - username
                        - password
                        - label
                        - enabled
                        - connections
                        - is_trial
                        - exp_date
                        - start_date
                        - created_at
                required:
                  - offset
                  - limit
                  - totalHits
                  - totalReturns
                  - hasNextPage
                  - hasPreviousPage
                  - nextOffset
                  - previousOffset
                  - lines
        '400':
          description: 'Bad Request: Errors in supplied parameters.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - request_errors
                  message:
                    type: string
                    example: Request error occurred.
                  data:
                    type: object
                    properties:
                      errors:
                        type: array
                        items:
                          type: object
                          properties:
                            code:
                              type: string
                            message:
                              type: string
                            path:
                              type: array
                              items:
                                type: string
                          required:
                            - code
                            - message
                            - path
                    required:
                      - errors
                required:
                  - code
                  - message
                  - data
        '401':
          description: 'Auth Error: Not authorized.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - not_authorized
                  message:
                    type: string
                    example: Not authorized to perform this action.
                required:
                  - code
                  - message
        '429':
          description: 'Rate limit error: too many requests.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - rate_limit
                  message:
                    type: string
                    example: Rate limit exceeded.
                required:
                  - code
                  - message
        '500':
          description: 'Server Error: handler died.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                    enum:
                      - server_error
                  message:
                    type: string
                    example: Internal server error occurred.
                  requestId:
                    type: string
                required:
                  - code
                  - message
                  - requestId
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      description: API Key
      name: x-api-key
      in: header

````