Coperniq

Coperniq payments API

The payments API from Coperniq — 4 operation(s) for payments.

GitHub OpenAPI

Operations 6

GET /invoices/{invoiceId}/payments List Invoice Payments #
POST /invoices/{invoiceId}/payments Create Invoice Payment #
GET /invoices/{invoiceId}/payments/{paymentId} Get Invoice Payment #
GET /bills/{billId}/payments List Bill Payments #
POST /bills/{billId}/payments Create Bill Payment #
GET /bills/{billId}/payments/{paymentId} Get Bill Payment #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/coperniq/refs/heads/main/openapi/coperniq-payments-api-openapi.yml

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/coperniq-payments-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

coperniq-payments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Key accounts Payments API
  version: 1.0.0
servers:
- url: https://api.coperniq.io/v1
  description: Production server
tags:
- name: payments
paths:
  /invoices/{invoiceId}/payments:
    get:
      operationId: list-invoice-payments
      summary: List Invoice Payments
      description: 'Retrieve all payment records for an invoice.


        Amounts are returned in **dollars** (internal storage uses cents).

        '
      tags:
      - payments
      parameters:
      - name: invoiceId
        in: path
        description: Invoice identifier
        required: true
        schema:
          type: integer
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of payments for the invoice
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentListResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListInvoicePaymentsRequestBadRequestError'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListInvoicePaymentsRequestUnauthorizedError'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListInvoicePaymentsRequestNotFoundError'
    post:
      operationId: create-invoice-payment
      summary: Create Invoice Payment
      description: 'Record a manual payment against an invoice.


        **Request body**

        - `amount`: Positive number in **dollars**

        - `paymentDate`: ISO 8601 datetime string

        - `paymentMethod`: One of `CASH`, `ACH`, `CREDIT_CARD`, `KLARNA`, `AFFIRM`, `CHECK`

        - `notes` (optional)

        - `paymentReference` (optional)

        '
      tags:
      - payments
      parameters:
      - name: invoiceId
        in: path
        description: Invoice identifier
        required: true
        schema:
          type: integer
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Payment created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Payment'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateInvoicePaymentRequestBadRequestError'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateInvoicePaymentRequestUnauthorizedError'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateInvoicePaymentRequestNotFoundError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PaymentCreate'
  /invoices/{invoiceId}/payments/{paymentId}:
    get:
      operationId: get-invoice-payment
      summary: Get Invoice Payment
      description: 'Retrieve a single payment record on an invoice by payment id.


        Core does not expose a standalone payment-record GET; this resolves the payment from the invoice''s nested payment records.

        '
      tags:
      - payments
      parameters:
      - name: invoiceId
        in: path
        description: Invoice identifier
        required: true
        schema:
          type: integer
      - name: paymentId
        in: path
        description: Payment record identifier
        required: true
        schema:
          type: integer
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Payment details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Payment'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetInvoicePaymentRequestBadRequestError'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetInvoicePaymentRequestUnauthorizedError'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetInvoicePaymentRequestNotFoundError'
  /bills/{billId}/payments:
    get:
      operationId: list-bill-payments
      summary: List Bill Payments
      description: 'Retrieve all payment records for a bill.


        Amounts are returned in **dollars** (internal storage uses cents).

        '
      tags:
      - payments
      parameters:
      - name: billId
        in: path
        description: Bill identifier
        required: true
        schema:
          type: integer
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of payments for the bill
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillPaymentListResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBillPaymentsRequestBadRequestError'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBillPaymentsRequestUnauthorizedError'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListBillPaymentsRequestNotFoundError'
    post:
      operationId: create-bill-payment
      summary: Create Bill Payment
      description: 'Record a manual payment against a bill.


        **Request body**

        - `amount`: Positive number in **dollars**

        - `paymentDate`: ISO 8601 datetime string

        - `paymentMethod`: One of `CASH`, `ACH`, `CREDIT_CARD`, `KLARNA`, `AFFIRM`, `CHECK`

        - `notes` (optional)

        - `paymentReference` (optional)

        '
      tags:
      - payments
      parameters:
      - name: billId
        in: path
        description: Bill identifier
        required: true
        schema:
          type: integer
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Payment created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillPayment'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateBillPaymentRequestBadRequestError'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateBillPaymentRequestUnauthorizedError'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateBillPaymentRequestNotFoundError'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PaymentCreate'
  /bills/{billId}/payments/{paymentId}:
    get:
      operationId: get-bill-payment
      summary: Get Bill Payment
      description: 'Retrieve a single payment record on a bill by payment id.


        Core does not expose a standalone payment-record GET; this resolves the payment from the bill''s nested payment records.

        '
      tags:
      - payments
      parameters:
      - name: billId
        in: path
        description: Bill identifier
        required: true
        schema:
          type: integer
      - name: paymentId
        in: path
        description: Payment record identifier
        required: true
        schema:
          type: integer
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Payment details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillPayment'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBillPaymentRequestBadRequestError'
        '401':
          description: Authentication failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBillPaymentRequestUnauthorizedError'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBillPaymentRequestNotFoundError'
components:
  schemas:
    CreateBillPaymentRequestNotFoundError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/BillsBillIdPaymentsPostResponsesContentApplicationJsonSchemaCode'
      title: CreateBillPaymentRequestNotFoundError
    CreateInvoicePaymentRequestBadRequestError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/InvoicesInvoiceIdPaymentsPostResponsesContentApplicationJsonSchemaCode'
        field:
          type: string
          description: Field that caused the validation error (if applicable)
      title: CreateInvoicePaymentRequestBadRequestError
    GetInvoicePaymentRequestBadRequestError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/InvoicesInvoiceIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode'
        field:
          type: string
          description: Field that caused the validation error (if applicable)
      title: GetInvoicePaymentRequestBadRequestError
    ListInvoicePaymentsRequestUnauthorizedError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/InvoicesInvoiceIdPaymentsGetResponsesContentApplicationJsonSchemaCode'
      title: ListInvoicePaymentsRequestUnauthorizedError
    CreateBillPaymentRequestUnauthorizedError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/BillsBillIdPaymentsPostResponsesContentApplicationJsonSchemaCode'
      title: CreateBillPaymentRequestUnauthorizedError
    BillPayment:
      type: object
      properties:
        id:
          type: integer
          description: Payment record identifier
        billNumber:
          type:
          - integer
          - 'null'
          description: Payment display number (when present)
        amount:
          type: number
          format: double
          description: Payment amount in dollars
        status:
          type: string
          description: Payment status
        paymentMethod:
          type: string
          description: Payment method (e.g. CASH, ACH, CREDIT_CARD, CHECK)
        paymentDate:
          type:
          - string
          - 'null'
          format: date-time
          description: When the payment was recorded (ISO 8601); null if absent from upstream
        paymentReference:
          type:
          - string
          - 'null'
        notes:
          type:
          - string
          - 'null'
        isExternal:
          type:
          - boolean
          - 'null'
          description: Whether the payment originated from an external processor (e.g. Stripe)
        createdAt:
          type:
          - string
          - 'null'
          format: date-time
        updatedAt:
          type:
          - string
          - 'null'
          format: date-time
        createdBy:
          oneOf:
          - $ref: '#/components/schemas/BillPaymentCreatedBy'
          - type: 'null'
      required:
      - id
      - amount
      - status
      - paymentMethod
      title: BillPayment
    InvoicesInvoiceIdPaymentsPostResponsesContentApplicationJsonSchemaCode:
      type: string
      enum:
      - NOT_FOUND
      title: InvoicesInvoiceIdPaymentsPostResponsesContentApplicationJsonSchemaCode
    ListInvoicePaymentsRequestNotFoundError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/InvoicesInvoiceIdPaymentsGetResponsesContentApplicationJsonSchemaCode'
      title: ListInvoicePaymentsRequestNotFoundError
    BillPaymentCreatedBy:
      type: object
      properties:
        id:
          type: integer
        firstName:
          type:
          - string
          - 'null'
        lastName:
          type:
          - string
          - 'null'
      title: BillPaymentCreatedBy
    BillsBillIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode:
      type: string
      enum:
      - NOT_FOUND
      title: BillsBillIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode
    GetBillPaymentRequestBadRequestError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/BillsBillIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode'
        field:
          type: string
          description: Field that caused the validation error (if applicable)
      title: GetBillPaymentRequestBadRequestError
    InvoicesInvoiceIdPaymentsGetResponsesContentApplicationJsonSchemaCode:
      type: string
      enum:
      - NOT_FOUND
      title: InvoicesInvoiceIdPaymentsGetResponsesContentApplicationJsonSchemaCode
    GetInvoicePaymentRequestUnauthorizedError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/InvoicesInvoiceIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode'
      title: GetInvoicePaymentRequestUnauthorizedError
    CreateInvoicePaymentRequestUnauthorizedError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/InvoicesInvoiceIdPaymentsPostResponsesContentApplicationJsonSchemaCode'
      title: CreateInvoicePaymentRequestUnauthorizedError
    GetInvoicePaymentRequestNotFoundError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/InvoicesInvoiceIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode'
      title: GetInvoicePaymentRequestNotFoundError
    InvoicesInvoiceIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode:
      type: string
      enum:
      - NOT_FOUND
      title: InvoicesInvoiceIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode
    Payment:
      type: object
      properties:
        id:
          type: integer
          description: Payment record identifier
        invoiceNumber:
          type:
          - integer
          - 'null'
          description: Payment display number (when present)
        amount:
          type: number
          format: double
          description: Payment amount in dollars
        status:
          type: string
          description: Payment status
        paymentMethod:
          type: string
          description: Payment method (e.g. CASH, ACH, CREDIT_CARD, CHECK)
        paymentDate:
          type:
          - string
          - 'null'
          format: date-time
          description: When the payment was recorded (ISO 8601); null if absent from upstream
        paymentReference:
          type:
          - string
          - 'null'
        notes:
          type:
          - string
          - 'null'
        isExternal:
          type:
          - boolean
          - 'null'
          description: Whether the payment originated from an external processor (e.g. Stripe)
        createdAt:
          type:
          - string
          - 'null'
          format: date-time
        updatedAt:
          type:
          - string
          - 'null'
          format: date-time
        createdBy:
          oneOf:
          - $ref: '#/components/schemas/PaymentCreatedBy'
          - type: 'null'
      required:
      - id
      - amount
      - status
      - paymentMethod
      title: Payment
    ListBillPaymentsRequestBadRequestError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/BillsBillIdPaymentsGetResponsesContentApplicationJsonSchemaCode'
        field:
          type: string
          description: Field that caused the validation error (if applicable)
      title: ListBillPaymentsRequestBadRequestError
    ListBillPaymentsRequestNotFoundError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/BillsBillIdPaymentsGetResponsesContentApplicationJsonSchemaCode'
      title: ListBillPaymentsRequestNotFoundError
    BillsBillIdPaymentsPostResponsesContentApplicationJsonSchemaCode:
      type: string
      enum:
      - NOT_FOUND
      title: BillsBillIdPaymentsPostResponsesContentApplicationJsonSchemaCode
    PaymentListResponse:
      type: array
      items:
        $ref: '#/components/schemas/Payment'
      title: PaymentListResponse
    CreateInvoicePaymentRequestNotFoundError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/InvoicesInvoiceIdPaymentsPostResponsesContentApplicationJsonSchemaCode'
      title: CreateInvoicePaymentRequestNotFoundError
    GetBillPaymentRequestUnauthorizedError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/BillsBillIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode'
      title: GetBillPaymentRequestUnauthorizedError
    PaymentCreatedBy:
      type: object
      properties:
        id:
          type: integer
        firstName:
          type:
          - string
          - 'null'
        lastName:
          type:
          - string
          - 'null'
      title: PaymentCreatedBy
    ListInvoicePaymentsRequestBadRequestError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/InvoicesInvoiceIdPaymentsGetResponsesContentApplicationJsonSchemaCode'
        field:
          type: string
          description: Field that caused the validation error (if applicable)
      title: ListInvoicePaymentsRequestBadRequestError
    CreateBillPaymentRequestBadRequestError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/BillsBillIdPaymentsPostResponsesContentApplicationJsonSchemaCode'
        field:
          type: string
          description: Field that caused the validation error (if applicable)
      title: CreateBillPaymentRequestBadRequestError
    PaymentCreate:
      type: object
      properties:
        amount:
          type: number
          format: double
          description: Payment amount in dollars
        paymentMethod:
          $ref: '#/components/schemas/PaymentCreatePaymentMethod'
        paymentDate:
          type: string
          format: date-time
        notes:
          type: string
          description: Optional notes about the payment
        paymentReference:
          type:
          - string
          - 'null'
      required:
      - amount
      - paymentMethod
      - paymentDate
      title: PaymentCreate
    BillsBillIdPaymentsGetResponsesContentApplicationJsonSchemaCode:
      type: string
      enum:
      - NOT_FOUND
      title: BillsBillIdPaymentsGetResponsesContentApplicationJsonSchemaCode
    GetBillPaymentRequestNotFoundError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/BillsBillIdPaymentsPaymentIdGetResponsesContentApplicationJsonSchemaCode'
      title: GetBillPaymentRequestNotFoundError
    PaymentCreatePaymentMethod:
      type: string
      enum:
      - CASH
      - ACH
      - CREDIT_CARD
      - KLARNA
      - AFFIRM
      - CHECK
      title: PaymentCreatePaymentMethod
    ListBillPaymentsRequestUnauthorizedError:
      type: object
      properties:
        message:
          type: string
        code:
          $ref: '#/components/schemas/BillsBillIdPaymentsGetResponsesContentApplicationJsonSchemaCode'
      title: ListBillPaymentsRequestUnauthorizedError
    BillPaymentListResponse:
      type: array
      items:
        $ref: '#/components/schemas/BillPayment'
      title: BillPaymentListResponse
  securitySchemes:
    BasicAuth:
      type: http
      scheme: basic