GetCurrentOffer API

openapi: 3.1.0
info:
  title: GetCurrentOffer API
  version: '2026-11-09'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-09: 5 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; GetCurrentOffer has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 4
    pages-with-code: 2
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-09'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://getcurrentoffer.com/docs
  - https://getcurrentoffer.com/docs/mcp
paths:
  /api/v1/issuers:
    get:
      operationId: get_api_v1_issuers
      tags:
      - Api
      summary: List all card issuers with offer counts.
      description: Returns a list of card issuers along with the count of offers associated with each issuer.
      x-source: https://getcurrentoffer.com/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/merchants:
    get:
      operationId: get_api_v1_merchants
      tags:
      - Api
      summary: List all merchants with active offers and offer counts.
      description: Provides a list of merchants that currently have active offers, including the number of offers per merchant.
      x-source: https://getcurrentoffer.com/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/offers:
    get:
      operationId: get_api_v1_offers
      tags:
      - Api
      summary: GET /api/v1/offers
      x-source: https://getcurrentoffer.com/docs
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1OffersResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -H "Authorization: Bearer gco_your_key_here" https://getcurrentoffer.com/api/v1/offers'
  /api/v1/offers/{id}:
    get:
      operationId: get_api_v1_offers_id
      tags:
      - Api
      summary: Get a single offer by its ID.
      description: Returns detailed information for the offer identified by the provided ID.
      x-source: https://getcurrentoffer.com/docs
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /mcp:
    post:
      operationId: post_mcp
      tags:
      - Mcp
      summary: One endpoint, JSON‑RPC 2.0 over POST
      description: POST a JSON‑RPC 2.0 request to https://getcurrentoffer.com/mcp to call tools such as search_offers.
      x-source: https://getcurrentoffer.com/docs/mcp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostMcpRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostMcpResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiV1OffersResponse:
      type: object
      properties:
        headers:
          type: object
          properties:
            X-API-Key:
              type: string
    PostMcpRequest:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON‑RPC version, must be "2.0"
        id:
          type: integer
          description: Request identifier
        method:
          type: string
          description: JSON‑RPC method name, e.g. "tools/call"
        params:
          type: object
          description: Parameters for the method
        params.name:
          type: string
          description: Tool name, e.g. "search_offers"
        params.arguments:
          type: object
          description: Arguments for the tool
        params.arguments.store:
          type: string
          description: Store name to search offers for
        params.arguments.spend:
          type: number
          description: Optional spend amount
      required:
      - jsonrpc
      - id
      - method
      - params
      - params.name
      - params.arguments
      - params.arguments.store
    PostMcpResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON‑RPC version, "2.0"
        id:
          type: integer
          description: Matches the request id
        result:
          type: object
          description: Result of the tool call, containing offers and estimated savings
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Mcp