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

# Get PTR

> This endpoint retrieves the PTR (Reverse DNS) records for specified IP addresses.  
Provide the `signature`, `kvm_id`, `valid_until`, `api_host`, and a JSON-encoded list of IP addresses to query their PTR records.




## OpenAPI

````yaml post /get/ptr
openapi: 3.0.0
info:
  title: EDIS Global Management API
  description: >
    Use the API to access and manage your VPS services, including power control,
    rDNS, and VNC management.  

    **Authentication:** Enable API access on any KVM VPS you own. Then use the
    provided credentials to authenticate your requests.
  version: 1.0.0
servers:
  - url: https://{api_host}
    description: Dynamic API host returned from the AUTH session endpoint.
    variables:
      api_host:
        default: api_host.edisglobal.com
        description: >-
          Enter the full API host exactly as returned by /kvm/v2/get/auth (for
          example: 12345.edisglobal.com)
security: []
tags:
  - name: Authentication
    description: Create an AUTH Session
  - name: Power Management
    description: KVM Power Management
  - name: Installation
    description: ISO, Turnkey, Reinstall
  - name: Settings
    description: KVM System Settings
  - name: Collect Information
    description: KVM VPS Details.
  - name: VNC Management
    description: KVM VNC Access
  - name: PTR
    description: KVM Reverse DNS
  - name: Traffic Pool
    description: Traffic Pool Management
  - name: Hooks
    description: KVM Webhook Management
paths:
  /get/ptr:
    servers:
      - url: https://dns-api.edisglobal.com
        description: Reverse DNS API Server
    post:
      tags:
        - PTR
      summary: Get PTR Records
      description: >
        This endpoint retrieves the PTR (Reverse DNS) records for specified IP
        addresses.  

        Provide the `signature`, `kvm_id`, `valid_until`, `api_host`, and a
        JSON-encoded list of IP addresses to query their PTR records.
      operationId: getPTR
      requestBody:
        description: Required parameters to retrieve PTR records.
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/get_ptr_body'
        required: true
      responses:
        '200':
          description: PTR records retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/inline_response_200_19'
        '400':
          description: Bad Request - The request contains missing or invalid parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/inline_response_400_15'
        '401':
          description: >-
            Unauthorized - The provided session signature is invalid or has
            expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/inline_response_401_14'
        '500':
          description: Internal Server Error - An unexpected error occurred on the server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/inline_response_500_14'
components:
  schemas:
    get_ptr_body:
      type: object
      properties:
        signature:
          type: string
          description: The session signature obtained from the "get session" call.
          example: session_signature_12345
        kvm_id:
          type: string
          description: The unique identifier of the KVM to query PTR records for.
          example: kvm_123456_789012
        valid_until:
          type: string
          description: >-
            The expiration timestamp of the session obtained from the "get
            session" call.
          example: '1737476000'
        api_host:
          type: string
          description: The API host URL obtained from the "get session" call.
          example: api_host.edisglobal.com
        ip:
          type: array
          description: A JSON-encoded list of IP addresses to query their PTR records.
          example:
            - 192.168.1.1
            - 192.168.1.2
            - 2001:db8:abcd:0012::1
          items:
            type: string
    inline_response_200_19:
      type: object
      properties:
        status:
          type: string
          description: The status of the operation.
          example: success
        records:
          type: array
          items:
            $ref: '#/components/schemas/inline_response_200_19_records'
    inline_response_400_15:
      type: object
      properties:
        status:
          type: string
          description: Indicates the status of the request.
          example: error
        error:
          type: string
          description: Details about the missing or invalid parameters.
          example: Required field 'kvm_id' is missing.
    inline_response_401_14:
      type: object
      properties:
        status:
          type: string
          description: Indicates the status of the request.
          example: error
        error:
          type: string
          description: Explanation of the authentication failure.
          example: Session signature has expired.
    inline_response_500_14:
      type: object
      properties:
        status:
          type: string
          description: Indicates the status of the request.
          example: error
        error:
          type: string
          description: A message providing details of the server error.
          example: An internal server error occurred. Please try again later.
    inline_response_200_19_records:
      type: object
      properties:
        ip:
          type: string
          description: The queried IP address.
          example: 192.168.1.1
        ptr_record:
          type: string
          description: The PTR record associated with the IP address.
          example: example.com

````