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/narmi-merchants-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: Narmi Public account balances Merchants API
  version: v1
  description: To read about Public API access and authentication, go to [API Overview](https://docs.narmi.com/docs/narmi-developer-docs/xl9dvbz84o11l-introduction).
  termsOfService: https://www.narmi.com/policies/developer-terms-conditions
  contact:
    name: Narmi Support
    email: support@narmi.com
servers:
- url: https://api.sandbox.narmi.dev/
  description: ''
tags:
- name: merchants
paths:
  /v1/merchants/:
    get:
      operationId: merchants_list
      description: 'Retrieve a list of popular merchants for subscriptions and relevant cancellation details.


        All monetary values are represented in minor units, or the smallest unit of the currency with no decimal (e.g., cents). For example, $10.00 is represented as 1000.




        <i>How can we improve these docs?             <a href="mailto:docs+feedback@narmi.com">Share your feedback.</a></i>'
      summary: Retrieve merchants
      tags:
      - merchants
      security:
      - oauth2:
        - read
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Merchant'
          description: ''
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  message:
                    type: string
              examples:
                AuthenticationFailed:
                  value:
                    id: authentication_failed
                    message: Incorrect authentication credentials.
          description: ''
        '500':
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  message:
                    type: string
              examples:
                ServiceFailureError:
                  value:
                    id: service_failure_error
                    message: Sorry, we were unable to process your request, please check back soon.
          description: ''
      x-stoplight:
        id: lbkkcxlhrnvjh
components:
  schemas:
    Merchant:
      type: object
      properties:
        merchant_name:
          type: string
          description: The name of the merchant associated with the transaction.
          maxLength: 100
        website_url:
          type: string
          format: uri
          description: The website URL of the merchant.
          maxLength: 255
        cancellation_url:
          type:
          - string
          - 'null'
          format: uri
          description: The cancellation URL of the merchant.
          maxLength: 255
        logo_url:
          type:
          - string
          - 'null'
          readOnly: true
        contact_number:
          type:
          - string
          - 'null'
          description: The contact number of the merchant.
          maxLength: 20
        contact_email:
          type:
          - string
          - 'null'
          format: email
          description: The contact email of the merchant.
          maxLength: 100
        cancellation_instructions:
          type:
          - array
          - 'null'
          items:
            type: string
            maxLength: 500
          description: Instructions for cancelling a subscription with the merchant.
      required:
      - merchant_name
      - website_url
      x-stoplight:
        id: drdbt5axwltjc
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: /v2/oauth/authorize/
          tokenUrl: /v2/oauth/token/
          scopes:
            banking:accounts:read: Can read account information.
            banking:transactions:read: Can read transaction information.
            banking:scheduled_transfers:read: Can read scheduled transfer information.
            banking:scheduled_transfers:write: Can create and update scheduled transfers.
            banking:accounts:write: Can update account information.
            banking:transactions:write: Can update transaction information.
            banking:users:read: Can read user profile information.
            banking:products:read: Can read product information.
            banking:documents:read: Can read user statements and documents.
x-stoplight:
  id: 68n444msv6n7x