Mintsoft · OpenAPI Overlay 1.0.0
API Evangelist conversational phrasing for Accounting API
16 actions
16 updates
phrasing
extends
openapi/mintsoft-accounting-api-openapi.yml
Generated by API Evangelist
Written by API Evangelist tooling for Mintsoft's API. It is a proposal applied on top of the contract, not a document Mintsoft publishes.
What the actions change
x-apievangelist-phrasing
Targets 16
$.info
$.paths['/api/Accounting/Invoice/List'].get
$.paths['/api/Accounting/Invoice/All'].get
$.paths['/api/Accounting/Invoice/{id}'].get
$.paths['/api/Accounting/Invoice/{id}/Orders'].get
$.paths['/api/Accounting/Invoice/Orders/{OrderId}'].get
$.paths['/api/Accounting/AddCourierCost'].post
$.paths['/api/Accounting/Invoice/{id}/Returns'].get
$.paths['/api/Accounting/Invoice/{id}/GoodsIn'].get
$.paths['/api/Accounting/Invoice/{id}/Collections'].get
$.paths['/api/Accounting/Invoice/{id}/Other'].get
$.paths['/api/Account/Invoice/InvoiceItemTypes'].get
$.paths['/api/Account/Invoice/AddAdditionalInvoiceItem'].post
$.paths['/api/Accounting/LocationTypeStoragePrice'].post
$.paths['/api/Account/Invoice/GetUnconfirmedInvoiceSummary'].get
$.paths['/api/Account/Invoice/GetUnconfirmedInvoiceStorageCosts'].get
OpenAPI Overlay
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
title: API Evangelist conversational phrasing for Accounting API
version: 1.0.0
extends: openapi/mintsoft-accounting-api-openapi.yml
actions:
- target: $.info
update:
x-apievangelist-phrasing:
method: generated
generated: '2026-11-20'
generator: build-phrasing.py
label: Generated by API Evangelist
operations: 15
- target: $.paths['/api/Accounting/Invoice/List'].get
update:
x-apievangelist-phrasing:
intent: List confirmed invoices
effect: read
questions:
- Which confirmed invoices have been raised for a client?
- Can I list invoices updated since a certain date?
instructions:
- text: List confirmed invoices for client {ClientId}.
slots:
ClientId: query.ClientId
- text: Show invoices updated since {SinceDate}.
slots:
SinceDate: query.SinceDate
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/All'].get
update:
x-apievangelist-phrasing:
intent: Get all confirmed invoices
effect: read
questions:
- Can I pull every confirmed invoice summary at once?
- Is there an unpaginated list of all invoices I can access?
instructions:
- text: Get all confirmed invoice summaries.
- text: Export every invoice I have access to.
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}'].get
update:
x-apievangelist-phrasing:
intent: Get a confirmed invoice
effect: read
questions:
- What are the totals on a specific confirmed invoice?
- Can I look up one invoice by its ID?
instructions:
- text: Get confirmed invoice {id}.
slots:
id: path.id
- text: Show the totals for invoice {id}.
slots:
id: path.id
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/Orders'].get
update:
x-apievangelist-phrasing:
intent: List an invoice's order charges
effect: read
questions:
- Which order charges make up a confirmed invoice?
- Can I see the line items from orders on an invoice?
instructions:
- text: List the order charges on invoice {id}.
slots:
id: path.id
- text: Show the order line items for invoice {id}.
slots:
id: path.id
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/Orders/{OrderId}'].get
update:
x-apievangelist-phrasing:
intent: Find the invoice item for an order
effect: read
questions:
- What did an order get charged on the invoice?
- Can I look up an invoice item by its order number?
instructions:
- text: Find the invoice item for order {OrderId}.
slots:
OrderId: path.OrderId
- text: Show how order {OrderId} was charged on the invoice.
slots:
OrderId: path.OrderId
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/AddCourierCost'].post
update:
x-apievangelist-phrasing:
intent: Add a courier cost to an invoice item
effect: write
questions:
- How do I add a courier cost to an invoice item that failed to price?
- Can I set a postage cost for a tracking number on an invoice item?
instructions:
- text: Add courier cost {PostageCost} to invoice item for order {OrderId}.
slots:
PostageCost: requestBody.PostageCost
OrderId: requestBody.OrderId
- text: Set postage cost {PostageCost} for tracking {TrackingNumber} on invoice item {OrderNumber}.
slots:
PostageCost: requestBody.PostageCost
TrackingNumber: requestBody.TrackingNumber
OrderNumber: requestBody.OrderNumber
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/Returns'].get
update:
x-apievangelist-phrasing:
intent: List an invoice's return charges
effect: read
questions:
- Which return charges are on a confirmed invoice?
- Can I see the return line items on an invoice?
instructions:
- text: List the return charges on invoice {id}.
slots:
id: path.id
- text: Show the return line items for invoice {id}.
slots:
id: path.id
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/GoodsIn'].get
update:
x-apievangelist-phrasing:
intent: List an invoice's goods in charges
effect: read
questions:
- Which goods in (ASN) charges are on a confirmed invoice?
- Can I see the goods in line items on an invoice?
instructions:
- text: List the goods in charges on invoice {id}.
slots:
id: path.id
- text: Show the ASN line items for invoice {id}.
slots:
id: path.id
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/Collections'].get
update:
x-apievangelist-phrasing:
intent: List an invoice's collection charges
effect: read
questions:
- Which collection charges are on a confirmed invoice?
- Can I see the collection line items on an invoice?
instructions:
- text: List the collection charges on invoice {id}.
slots:
id: path.id
- text: Show the collection line items for invoice {id}.
slots:
id: path.id
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/Invoice/{id}/Other'].get
update:
x-apievangelist-phrasing:
intent: List an invoice's generic charges
effect: read
questions:
- Which generic (additional) charges are on a confirmed invoice?
- Can I see the other line items on an invoice?
instructions:
- text: List the generic charges on invoice {id}.
slots:
id: path.id
- text: Show the other line items for invoice {id}.
slots:
id: path.id
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Account/Invoice/InvoiceItemTypes'].get
update:
x-apievangelist-phrasing:
intent: List additional invoice item types
effect: read
questions:
- What additional item types can I add to an invoice?
- Which invoice item types are available for additional charges?
instructions:
- text: List the additional invoice item types.
- text: Show the available invoice item types.
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Account/Invoice/AddAdditionalInvoiceItem'].post
update:
x-apievangelist-phrasing:
intent: Add an additional charge to an invoice
effect: write
questions:
- How do I add a one-off charge to an invoice?
- Can I add a generic item to an invoice for a specific warehouse?
instructions:
- text: Add {Type} item of {Amount} to invoice for client {ClientId} dated {InvoiceDate}.
slots:
Type: query.Type
Amount: query.Amount
ClientId: query.ClientId
InvoiceDate: query.InvoiceDate
- text: Add {Type} charge {Amount} to client {ClientId} invoice dated {InvoiceDate} with comment {Comment}.
slots:
Type: query.Type
Amount: query.Amount
ClientId: query.ClientId
InvoiceDate: query.InvoiceDate
Comment: query.Comment
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Accounting/LocationTypeStoragePrice'].post
update:
x-apievangelist-phrasing:
intent: Set a storage price for a location type
effect: write
questions:
- How do I set a storage cost per location type?
- Can I define a storage price that applies to a location type?
instructions:
- text: Set storage cost {Cost} for location type {LocationType}.
slots:
Cost: requestBody.Cost
LocationType: requestBody.LocationType
- text: Define a {Frequency} storage price of {Cost} for {LocationType} at client {Client}.
slots:
Frequency: requestBody.Frequency
Cost: requestBody.Cost
LocationType: requestBody.LocationType
Client: requestBody.Client
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Account/Invoice/GetUnconfirmedInvoiceSummary'].get
update:
x-apievangelist-phrasing:
intent: Summarize unconfirmed invoices
effect: read
questions:
- What is the total of unconfirmed invoices for a client?
- Can I get a summary of invoices not yet confirmed?
instructions:
- text: Summarize unconfirmed invoices for client {clientID} from {fromDate} to {toDate}.
slots:
clientID: query.clientID
fromDate: query.fromDate
toDate: query.toDate
- text: Give me the unconfirmed invoice total for {clientID} between {fromDate} and {toDate}.
slots:
clientID: query.clientID
fromDate: query.fromDate
toDate: query.toDate
method: generated
generated: '2026-11-20'
- target: $.paths['/api/Account/Invoice/GetUnconfirmedInvoiceStorageCosts'].get
update:
x-apievangelist-phrasing:
intent: List unconfirmed storage costs on invoices
effect: read
questions:
- Which storage costs are still unconfirmed on invoices?
- Can I page through unconfirmed invoice storage costs?
instructions:
- text: List unconfirmed storage costs for client {clientID} from {fromDate} to {toDate}.
slots:
clientID: query.clientID
fromDate: query.fromDate
toDate: query.toDate
- text: Show page {pageNo} of unconfirmed storage costs for {clientID} between {fromDate} and {toDate}, {limit} per page.
slots:
pageNo: query.pageNo
clientID: query.clientID
fromDate: query.fromDate
toDate: query.toDate
limit: query.limit
method: generated
generated: '2026-11-20'
Work with this as data
Every overlay 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 openapi overlays
4 MCP tools reach this
find_overlaysBrowse and filter every overlay in the catalog.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.
Call it yourself
curl for this page
This overlay
curl "https://apis.io/api/v1/overlays/mintsoft-accounting-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.