Talkable

Talkable Refunds API

The Refunds API from Talkable — 1 operation(s) for refunds.

Documentation GitHub OpenAPI

Operations 1

POST /api/v2/origins/{origin_slug}/refund Mark origin as refunded #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/talkable-refunds-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Talkable Advocate Offers Refunds API
  version: '2.0'
  contact:
    name: API Reference
    url: https://docs.talkable.com/api_v2/
servers:
- url: https://www.talkable.com
security:
- api_key: []
tags:
- name: Refunds
paths:
  /api/v2/origins/{origin_slug}/refund:
    post:
      summary: Mark origin as refunded
      tags:
      - Refunds
      parameters:
      - name: origin_slug
        in: path
        schema:
          $ref: '#/components/schemas/origin_slug'
        required: true
      operationId: markOriginAsRefunded
      responses:
        '200':
          description: null
          content:
            application/json:
              examples:
                origin marked as fully refunded:
                  value:
                    ok: true
                    result:
                      origin:
                        subtotal: 100.44
                        customer_id: null
                        email: customer@example.com
                        id: 1
                        ip_address: 1.2.3.4
                        order_number: B00K2EOONI
                        refunded_at: '2026-07-07T11:07:44.000-07:00'
                        type: Purchase
                        segment1: test
                        segment2: null
                        segment3: null
                        utm_campaign: null
                        utm_content: null
                        utm_medium: null
                        utm_source: null
                        utm_term: null
                        order_date: '2026-07-07T11:07:44.000-07:00'
                        partially_refunded: false
                        refund_subtotal: 100.44
                        coupon_code: ''
                origin marked as partially refunded:
                  value:
                    ok: true
                    result:
                      origin:
                        subtotal: 100.44
                        customer_id: null
                        email: customer@example.com
                        id: 1
                        ip_address: 1.2.3.4
                        order_number: B00K2EOONI
                        refunded_at: '2026-07-07T11:07:45.000-07:00'
                        type: Purchase
                        segment1: test
                        segment2: null
                        segment3: null
                        utm_campaign: null
                        utm_content: null
                        utm_medium: null
                        utm_source: null
                        utm_term: null
                        order_date: '2026-07-07T11:07:45.000-07:00'
                        partially_refunded: true
                        refund_subtotal: 25.11
                        coupon_code: ''
        '400':
          description: origin has already been refunded
          content:
            application/json:
              example:
                ok: false
                error_message: Origin has already been refunded
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                site_slug:
                  $ref: ../schemas.yaml#/site_slug
                data:
                  type: object
                  properties:
                    refunded_at:
                      $ref: ../schemas.yaml#/date_time
                    refund_subtotal:
                      type: number
                      format: float
                      example: 100.44
              required:
              - site_slug
components:
  schemas:
    origin_slug:
      type: string
      example: B00K2EOONI
      description: 'If origin is a ***Purchase***:


        `order_number`, e.g.: `"B00K2EOONI"`


        If origin is an ***Event***:


        `event_category:event_number`, e.g.: `"newsletter_subscription:42"`

        '
  securitySchemes:
    api_key:
      type: http
      scheme: bearer
      description: Please provide here your API key, you can find it in Site Settings -> API Integration -> API Key