/resellers/export - Export resellers to CSV or PDF

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://api.my.nethesis.it/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "my.nethesis.it MCP server": {
    "url": "https://api.my.nethesis.it/mcp"
  }
}
Close
GET /resellers/export
Bearer auth

Export resellers to CSV or PDF format with applied filters (max 10,000 resellers)

Query parameters

  • format string Required

    Export format (csv or pdf)

    Values are csv or pdf.

  • sort_by string

    Field to sort resellers by

    Values are name, description, created_at, updated_at, suspended_at, or creator_name.

  • sort_direction string

    Sort direction

    Values are asc or desc. Default value is asc.

  • organization_id array[string]

    Filter by owning organization Logto ID (custom_data.createdBy, the ownership key RBAC visibility walks). Supports multiple values; combine with include_hierarchy to cover a whole subtree. Results always stay within the caller's RBAC scope.

  • include_hierarchy boolean

    When true (and organization_id is provided), each organization_id is expanded to the organization plus all its descendants (a distributor's resellers and their customers, a reseller's customers) before filtering

    Default value is false.

Responses

  • 200

    Resellers exported successfully
  • 400 application/json

    Bad request - validation error

    Hide response attributes Show response attributes object
    • code integer

      HTTP error code

    • message string

      Error message

    • data object
      Hide data attributes Show data attributes object
      • type string

        Type of error

        Values are validation_error or external_api_error.

      • errors array[object]
        Hide errors attributes Show errors attributes object
        • key string

          Field name that failed validation

        • message string

          Error code or message

        • value string

          Value that failed validation

      • details

        Additional error details
  • 401 application/json

    Unauthorized - invalid or missing token

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object | null
  • 403 application/json

    Forbidden - insufficient permissions

    Hide response attributes Show response attributes object
    • code integer
    • message string
    • data object | null
GET /resellers/export 
curl \
 --request GET 'https://api.your-domain.com/api/resellers/export?format=csv' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (400) 
{
  "code": 400,
  "message": "validation failed",
  "data": {
    "type": "validation_error",
    "errors": [
      {
        "key": "username",
        "message": "required",
        "value": "string"
      }
    ]
  }
}
Response examples (401) 
{
  "code": 401,
  "message": "invalid token",
  "data": {}
}
Response examples (403) 
{
  "code": 403,
  "message": "insufficient permissions",
  "data": {}
}