Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HitchPin instant-invoices API

Invoices created by a seller.

HitchPin instant-invoices API is one of 3 APIs that HitchPin publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include instant-invoices. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 5 operations across 4 paths, and defines 7 schemas. It is described by OpenAPI 3.1.1, at version 2.0.0.

Requests are made against 5 base URLs: https://localhost, https://apiv2.sandbox.hitchpin.com, https://apiv2.staging.hitchpin.com, https://apiv2.demo.hitchpin.com, https://apiv2.hitchpin.com.

5 operations 4 paths 7 schemas 1 DELETE2 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.1
API Version
2.0.0
Base URL
https://apiv2.hitchpin.com
Authentication
API Key, API Key
Resource Areas
1

Authentication & Security 2

HitchPin instant-invoices API declares 2 security schemes for authenticating requests. An API key is passed in the cookie as sessionid (cookieAuth). An API key is passed in the header as Authorization (tokenAuth).

  • tokenAuth — Token-based authentication with required prefix "Token"

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

instant-invoices 5

Invoices created by a seller.

GET
/instant-invoices/
list_instant_invoices 2 params → 200404
POST
/instant-invoices/
create_instant_invoices body → 201404
GET
/instant-invoices/{invoice_number}/
retrieve_instant_invoices 1 param → 200404
DELETE
/instant-invoices/{invoice_number}/revoke/
Action that allows the owner (seller) of an InstantInvoice to revoke it.
void_instant_invoice 1 param → 204400404
POST
/instant-invoices/{invoice_number}/share/
Action that allows the owner (seller) of an InstantInvoice to share it with a contact.
share_instant_invoice 1 param body → 200400404

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are InstantInvoice (13 properties), Nested (10 properties), InstantInvoiceShare (10 properties), Attachment (8 properties). Each schema is shown below with its type and property counts.

ShareableInstantInvoice
object
6 properties
PaginatedInstantInvoiceList
object
4 properties 2 required
InstantInvoiceRequest
object
4 properties 1 required
Attachment
object
8 properties
InstantInvoiceShare
object
10 properties
Nested
object
10 properties 1 required
InstantInvoice
object
13 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hitchpin-instant-invoices-api-openapi.yml Raw ↑

Other APIs HitchPin publishes across the network.

HitchPin instant-invoice-share API
HitchPin rendering API