Admin

List listings for review

Every listing in one state, newest first — in_review by default, the queue an operator works through.

get/v1/admin/listings

Request

  • Base URL: https://api.naturali.ai
  • URL: https://api.naturali.ai/v1/admin/listings
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)

Query parameters

state'draft' | 'in_review' | 'listed' | 'suspended'

draft until submitted, in_review until naturali decides, listed in the marketplace, suspended when paused by its publisher or by naturali.

Example:listed
limitinteger

Results per page, 1 to 100 (default 50). Above 100 it is clamped; below 1 or not an integer it is 400.

cursorstring

The next_cursor of the previous page.

Response

A page of listings.

next_cursorstring nullable required

Cursor for the next page, or null when there are no more.

Example response

{
  "data": [
    {
      "id": "lst_V1StGXR8Z5jdHi6B",
      "project_id": "proj_V1StGXR8Z5jdHi6B",
      "resource_type": "tool",
      "resource_id": "tool_V1StGXR8Z5jdHi6B",
      "title": "Invoice OCR",
      "description": "Reads a scanned invoice and returns its fields.",
      "pricing": [
        {
          "component": "page",
          "unit": "count",
          "quantity": {
            "var": "response.page_count"
          },
          "unit_price_usd": 0.002
        }
      ],
      "pricing_next": {
        "effective_from": "2026-10-08T00:01:00.000Z",
        "pricing": [
          {
            "component": "page",
            "unit": "count",
            "quantity": {
              "var": "response.page_count"
            },
            "unit_price_usd": 0.002
          }
        ]
      },
      "state": "listed",
      "created_at": "2026-10-01T00:00:00.000Z",
      "updated_at": "2026-10-01T00:00:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.