---
title: "Get one full provider catalog document"
method: GET
path: "/credits/catalog/{provider}"
tags: ["Catalog"]
---

# Get one full provider catalog document

`GET /credits/catalog/{provider}`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/catalog/{provider}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Fetches executable endpoint schemas and the reviewed model inventory only for the selected provider. For this operation, slug must be one provider ID. Use after the compact list, not as a polling endpoint.

## Path parameters

- `provider` string, required

## Response `200`

Full enterprise detail or the price-safe personal projection

- union
  - CatalogProviderDetailResponse
    - `success` unknown, required
    - `version` '2026-09-06', required
    - `view` 'detail', required
    - `tenant` object, required
      - `defaultMarkupBps` integer, required
      - `defaultFlatMarkupUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
      - `creditsPerDollar` integer, required
    - `provider` CatalogProvider, required
      - `provider` string, required
      - `name` string
      - `description` string
      - `category` string
      - `secondaryCategories` string[]: Additional marketplace categories beyond the primary (Parse), so catalogs can file a provider under every category its marketplace lists it in.
      - `verified` boolean
      - `logoUrl` string, uri
      - `iconFallback` object, required
        - `type` 'monogram', required
        - `text` string, required
      - `serviceUrl` string, uri, required
      - `websiteUrl` string, uri
      - `docsUrl` string, uri
      - `catalogPriority` integer
      - `catalogIdentity` string
      - `attribution` object
        - `name` string, required
        - `websiteUrl` string, uri
        - `logoUrl` string, uri
      - `marketplaceRank` integer
      - `marketplaceFeatured` boolean
      - `externalRail` 'mpp' | 'x402'
      - `availability` 'available' | 'temporarily_unavailable' | 'unknown': Current platform readiness. Omitted from compact agent projections.
      - `unavailableReason` 'delivery_breaker' | 'platform_pause' | 'null', nullable
      - `modelCatalog` InferenceModelCatalog
        - `schemaVersion` '2026-08-01', required
        - `pricingVersion` string, required
        - `provider` string, required
        - `publishedAt` string, date-time, required
        - `freshness` object, required
          - `maxAgeSeconds` integer, required
          - `staleAfter` string, date-time, required
          - `source` 'locus-reviewed-static', required
        - `models` InferenceModelMetadata[], required
          - `id` string, required
          - `status` 'active' | 'deprecated', required
          - `deprecationDate` string, date, nullable, required
          - `contextWindowTokens` integer, required
          - `providerMaxOutputTokens` integer, required
          - `locusMaxOutputTokens` integer, required
          - `recommendedMinOutputTokens` integer, required
          - `pricing` object, required
            - `unit` 'usd_per_1m_tokens', required
            - `input` string, required
            - `output` string, required
          - `capabilities` InferenceModelCapabilities, required
            - `text` boolean, required
            - `vision` boolean, required
            - `tools` boolean, required
            - `json` boolean, required
            - `streaming` boolean, required: Capability of the current Locus credits route, not only the upstream model.
            - `reasoning` boolean, required
          - `request` object, required
            - `outputTokenField` 'max_tokens' | 'max_completion_tokens', required
            - `incompatibleFields` string[], required
      - `endpoints` CatalogEndpoint[], required
        - `slug` string, required
        - `method` string, required
        - `name` string
        - `description` string
        - `estimatedCost` string
        - `billingModel` 'usage' | 'prepaid_runtime': Variable charge collection model; omitted for ordinary fixed-price actions.
        - `inputSchema` object, required: The same usable JSON Schema published by MCP tools/list for this endpoint.
        - `inputExample` object, required: Canonical example arguments accepted by inputSchema.
        - `dynamic` boolean, required
        - `enabled` boolean, required
        - `availability` 'available' | 'temporarily_unavailable' | 'unknown': Current platform readiness. This is separate from tenant enablement.
        - `unavailableReason` 'delivery_breaker' | 'platform_pause' | 'null', nullable
        - `systemManaged` unknown
        - `route` string: Exact execution route for a system-managed capability.
        - `previewRoute` string: No-dispatch estimate route for a system-managed capability.
        - `markupBps` integer, required
        - `overridden` boolean, required
        - `markupSource` 'endpoint' | 'provider' | 'global', required
        - `flatSource` 'endpoint' | 'provider' | 'global', required
        - `flatMarkupUsdc` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `flatMarkupUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `baseUsdc` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `chargedUsdc` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `effectiveUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `marginUsdc` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `baseCredits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `effectiveCredits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `marginCredits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
  - PersonalCatalogProviderDetailResponse
    - `success` unknown, required
    - `version` '2026-09-06', required
    - `view` 'detail', required
    - `tenant` PersonalCatalogTenant, required
      - `creditsPerDollar` integer, required
    - `provider` PersonalCatalogProvider, required
      - `provider` string, required
      - `name` string
      - `description` string
      - `category` string
      - `secondaryCategories` string[]: Additional marketplace categories beyond the primary (Parse), so catalogs can file a provider under every category its marketplace lists it in.
      - `verified` boolean: Whether the provider listing has been explicitly verified by its source catalog.
      - `logoUrl` string, uri, required
      - `serviceUrl` string, uri, required
      - `websiteUrl` string, uri
      - `docsUrl` string, uri
      - `marketplaceRank` integer
      - `marketplaceFeatured` boolean
      - `externalRail` 'mpp' | 'x402'
      - `availability` 'available' | 'temporarily_unavailable' | 'unknown': Current platform readiness. This is separate from tenant enablement.
      - `unavailableReason` 'delivery_breaker' | 'platform_pause' | 'null', nullable
      - `endpoints` PersonalCatalogEndpoint[], required
        - `slug` string, required
        - `method` string, required
        - `name` string
        - `description` string
        - `dynamic` boolean, required
        - `estimatedCost` string: Display-only quoted range for variable-price actions.
        - `billingModel` 'usage' | 'prepaid_runtime': Variable charge collection model; omitted for ordinary fixed-price actions.
        - `enabled` boolean, required
        - `mcpPinned` boolean, required
        - `availability` 'available' | 'temporarily_unavailable' | 'unknown': Current platform readiness. This is separate from tenant enablement.
        - `unavailableReason` 'delivery_breaker' | 'platform_pause' | 'null', nullable
        - `systemManaged` unknown
        - `chargedUsdc` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `effectiveUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `effectiveCredits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.

## Other responses

- `304`: The tenant-scoped provider detail is unchanged.
- `404`: Unknown provider.

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)