Square provides APIs for payment processing, point of sale, and business management solutions enabling developers to build custom commerce applications.
URL: Visit APIs.json URL
Run: Capabilities Using Naftiko
- Type: Index
- Position: Consumer
- Access: 3rd-Party
- Restaurant, Bookings, Catalog, Checkout, Customers, Disputes, Ecommerce, Financial Technology, Gift Cards, Inventory, Invoicing, Labor, Locations, Loyalty, Merchants, Orders, Payments, Point of Sale, Refunds, Retail, Subscriptions, Team, Terminal, Webhooks
- Created: 2025-02-08
- Modified: 2026-06-03
The Payments API lets applications take and manage payments by charging payment methods supported by the Web Payments SDK or In-App Payments SDK, including credit cards, gift cards, digital wallets, and ACH bank transfers. It can also record cash or external payments received outside of Square.
Human URL: https://developer.squareup.com/docs/payments-overview
- Commerce, Financial Technology, Payments, Point of Sale
The Orders API lets applications itemize payments using custom line items or catalog objects, send orders to physical Point of Sale devices for fulfillment, attach customers to payments, and search through all of a seller's past sales with itemization data.
Human URL: https://developer.squareup.com/docs/orders-api/what-it-does
- Commerce, Orders, Point of Sale
The Catalog API programmatically catalogs a Square seller's products for sale and services for hire, enabling applications to create, update, and manage catalog items, categories, variations, and pricing.
Human URL: https://developer.squareup.com/docs/catalog-api/what-it-does
- Catalog, Commerce, Products
The Inventory API programmatically manages a Square seller's inventory of catalog items, including updating and tracking inventory changes and retrieving inventory counts.
Human URL: https://developer.squareup.com/docs/inventory-api/what-it-does
- Commerce, Inventory, Retail
The Customers API lets applications create and manage customer profiles to streamline bookings, build loyalty programs, sell gift cards, and offer discounts. It enables syncing CRM systems with Square.
Human URL: https://developer.squareup.com/docs/customers
- Commerce, CRM, Customers
The Locations API lets applications create and manage the locations of a seller's business, including retrieving location details and managing location settings.
Human URL: https://developer.squareup.com/docs/locations-api
- Business Management, Commerce, Locations
The Team API lets applications create and manage a roster of team members, configure jobs, and synchronize team member data with external platforms including accounting and payroll systems.
Human URL: https://developer.squareup.com/docs/team/overview
- Business Management, Employees, Team
The Labor API is the timekeeping component of Square's team management APIs, enabling applications to manage time tracking and scheduling for team members, record hours worked, and handle breaks, wages, and declared cash tips for labor cost reporting and payroll.
Human URL: https://developer.squareup.com/docs/labor-api/what-it-does
- Business Management, Labor, Time Tracking
The Bookings API enables creating reservations of services provided by a seller's staff for customers at particular locations and times. Applications can create, update, cancel, and search for available bookings.
Human URL: https://developer.squareup.com/docs/bookings-api/what-it-is
- Appointments, Bookings, Scheduling
The Loyalty API allows applications to set up and manage loyalty programs, enroll buyers, accrue points, and redeem rewards. It works with the Orders API to manage loyalty accounts and rewards at participating locations.
Human URL: https://developer.squareup.com/docs/loyalty-api/overview
- Customer Engagement, Loyalty, Rewards
The Gift Cards API enables sellers to launch a gifting program with digital and physical gift cards. Applications can create, retrieve, link, and unlink gift cards, and manage gift card activities such as activating, loading, and redeeming.
Human URL: https://developer.squareup.com/docs/gift-cards/using-gift-cards-api
- Commerce, Customer Engagement, Gift Cards
The Invoices API lets applications request or automatically collect payments from customers for orders created using the Orders API. It supports creating, updating, publishing, and managing invoices with multiple payment schedules and methods.
Human URL: https://developer.squareup.com/docs/invoices-api/overview
- Billing, Invoices, Payments
The Subscriptions API enables sellers to generate recurring revenue by offering scheduled fulfillment of products or services. Applications can create and manage subscription plans with configurable billing periods, pricing, and discounts.
Human URL: https://developer.squareup.com/docs/subscriptions-api/overview
- Commerce, Recurring Payments, Subscriptions
The Checkout API creates Square-hosted checkout pages for collecting payments. Applications can generate payment links with a simple API call, supporting credit cards, debit cards, Google Pay, Apple Pay, Afterpay, and Cash App.
Human URL: https://developer.squareup.com/docs/checkout-api
- Checkout, Commerce, Payments
The Terminal API lets developers integrate Square in-person payments so custom POS applications can use Square Terminal for card chip and NFC payments, with EMV certification and PCI compliance built in.
Human URL: https://developer.squareup.com/docs/terminal-api/overview
- In-Person Payments, Point of Sale, Terminal
The Refunds API lets applications refund the entire payment amount or a portion of it for card payments, and record refunds of cash or external payments.
Human URL: https://developer.squareup.com/docs/payments-refunds
- Commerce, Payments, Refunds
The Disputes API manages payment disputes and chargebacks, allowing applications to list disputes, retrieve dispute details, challenge disputes by submitting evidence, and accept disputes.
Human URL: https://developer.squareup.com/docs/disputes-api/overview
- Chargebacks, Disputes, Payments
The Merchants API groups individual seller locations into larger organizations, with each merchant representing one organization or business that sells with Square.
Human URL: https://developer.squareup.com/docs/merchants-api
- Business Management, Commerce, Merchants
The Cards API lets applications save a credit or debit card on file for a customer, enabling faster future payments without re-entering card details.
Human URL: https://developer.squareup.com/docs/cards-api/overview
- Cards, Commerce, Payments
The Vendors API lets applications manage vendors and suppliers for a seller, enabling creation, retrieval, and updating of vendor information.
Human URL: https://developer.squareup.com/docs/vendors-api/manage-vendors-in-apps
- Inventory, Suppliers, Vendors
The Cash Drawers API is a reporting API for businesses that use a cash drawer with their Square Point of Sale terminals, providing filtered and paged lists of cash drawer shift data for a given location.
Human URL: https://developer.squareup.com/docs/cashdrawershift-api/reporting
- Cash Drawers, Point of Sale, Reporting
The Bank Accounts API lets applications retrieve a list of a seller's bank accounts and get details about specific bank accounts linked to a Square account.
Human URL: https://developer.squareup.com/docs/bank-accounts-api
- Bank Accounts, Financial Technology, Payments
The Payouts API lets applications get a list of deposits and withdrawals from a seller's bank accounts, providing visibility into funds movement.
Human URL: https://developer.squareup.com/docs/payouts-api/overview
- Financial Technology, Payments, Payouts
The Apple Pay API provides an easy way for platform developers to bulk activate Web Apple Pay with Square for merchants using their platform.
Human URL: https://developer.squareup.com/docs/web-payments/apple-pay
- Apple Pay, Digital Wallets, Payments
The Sites API lets applications retrieve basic details about Square Online sites belonging to a seller, such as site ID, title, and domain. It is used in combination with the Snippets API.
Human URL: https://developer.squareup.com/docs/sites-api/overview
- Ecommerce, Sites, Square Online
The Snippets API lets applications add custom scripts to a Square Online site. Snippets can run as modals, pop ups, or background jobs, offering a range of functionality to extend Square Online features.
Human URL: https://developer.squareup.com/docs/snippets-api/overview
- Ecommerce, Snippets, Square Online
The OAuth API lets applications obtain and manage access tokens that grant scoped, permissioned access to a seller's Square account, supporting the authorization code grant flow, token refresh, and token revocation for connecting third-party apps.
Human URL: https://developer.squareup.com/docs/oauth-api/overview
- Authentication, OAuth, Security
The Webhook Subscriptions API lets applications programmatically create and manage webhook subscriptions to receive real-time event notifications for changes to payments, orders, customers, inventory, and other Square resources.
Human URL: https://developer.squareup.com/docs/webhooks/overview
- Events, Notifications, Webhooks
The Events API lets applications search and retrieve the history of events that have occurred in a seller's Square account, providing an audit trail and the ability to replay or backfill webhook-style event data.
Human URL: https://developer.squareup.com/docs/events-api/overview
- Audit, Events, Webhooks
The Devices API lets applications create device codes to pair Square hardware such as Square Terminal and Square Register, and retrieve device details for managing point-of-sale devices.
Human URL: https://developer.squareup.com/docs/devices-api/overview
- Devices, Point of Sale, Terminal
The Customer Groups API lets applications create and manage groups of customers, enabling segmentation for targeted marketing, pricing rules, and loyalty programs.
Human URL: https://developer.squareup.com/docs/customer-groups-api/what-it-does
- CRM, Customer Groups, Customers
The Customer Segments API lets applications retrieve the smart, automatically maintained customer segments defined in a seller's Square Customer Directory, supporting targeted engagement based on buyer behavior.
Human URL: https://developer.squareup.com/docs/customer-segments-api/what-it-does
- CRM, Customer Segments, Customers
The Gift Card Activities API lets applications create and list gift card activities such as activating, loading, redeeming, adjusting, and refunding balances, providing a full ledger of gift card transactions.
Human URL: https://developer.squareup.com/docs/gift-cards/using-gift-card-activities-api
- Customer Engagement, Gift Cards, Transactions
The Custom Attributes APIs let applications define and attach custom metadata to core Square resources, including customers, orders, bookings, merchants, and locations, enabling tailored data models and integrations on top of the Square platform.
Human URL: https://developer.squareup.com/docs/customer-custom-attributes-api/overview
- Custom Attributes, Extensibility, Metadata
- Documentation
- APIReference
- OpenAPI
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
- NaftikoCapability
The Reporting API (Beta) provides a new way to access all of a business's data to build custom reports and integrations, surfacing sales, payments, and operational metrics across a seller's Square account.
Human URL: https://developer.squareup.com/docs/reporting-api
- Analytics, Business Intelligence, Reporting
The Channels API lets applications represent and manage the sales channels through which a seller transacts, enabling attribution of orders and payments to specific online or in-person channels.
Human URL: https://developer.squareup.com/docs/channels-api/overview
- Commerce, Omnichannel, Sales Channels
The Transfer Orders API lets applications create and manage transfers of inventory stock between a seller's locations, supporting multi-location retail and restaurant operations.
Human URL: https://developer.squareup.com/docs/transfer-orders-api/overview
- Commerce, Inventory, Transfer Orders
- Portal
- Documentation
- APIReference
- GettingStarted
- Authentication
- ChangeLog
- SDKs
- SDK
- Webhooks
- AsyncAPI
- Sandbox
- RateLimits
- Documentation
- GettingStarted
- Documentation
- Console
- Console
- SignUp
- Blog
- Support
- Pricing
- TermsOfService
- PrivacyPolicy
- Support
- Partners
- StatusPage
- GitHubOrganization
- OpenAPI
- StackOverflow
- X
- Support
- JSONSchema
- JSONSchema
- JSONSchema
- JSONSchema
- JSONSchema
- JSONSchema
- JSONSchema
- JSONLD
- Square Python SDK (SDK)
- Square Node.js SDK (SDK)
- Square Java SDK (SDK)
- Square .NET SDK (SDK)
- Square Ruby SDK (SDK)
- Square PHP SDK (SDK)
- Square Go SDK (SDK)
- Square Web SDK (SDK)
- Square Web Payments SDK Quickstart (CodeExamples)
- Square Mobile Payments SDK (iOS) (SDK)
- Square Mobile Payments SDK (Android) (SDK)
- Square Mobile Payments SDK (Flutter) (SDK)
- Square Mobile Payments SDK (React Native) (SDK)
- Square In-App Payments React Native Plugin (SDK)
- Square In-App Payments Quickstart (iOS) (CodeExamples)
- Square In-App Payments Quickstart (Android) (CodeExamples)
- Connect API Specification (OpenAPI)
- Rules
- Vocabulary
- MCP Server (MCPServer)
- MCP Server (Tools)
- Remote MCP Server (Hosted) (Tools)
- MCP Server Documentation (Documentation)
- MCP Server (npm) (SDK)
- LLMsTxt
- JSONStructure
- JSONStructure
- JSONStructure
- JSONStructure
- JSONStructure
- JSONStructure
- JSONStructure
- Example
- Example
- Example
- Example
- Example
- Example
- Example
- Plans
- RateLimits
- FinOps
| Name | Description |
|---|---|
| Tap/dip/swipe: 2.6%+15¢ Free, 2.5%+15¢ Plus, 2.4%+15¢ Premium | |
| Online (Square site): 3.3%+30¢ Free, 2.9%+30¢ Plus/Premium | |
| Online API: 2.9%+30¢ all plans | |
| Manual entry/card on file: 3.5%+15¢ all plans | |
| ACH (invoice): 1% $1 min ($10 cap on Plus/Premium) | |
| ACH (API): 1% $1 min, $5 cap | |
| Afterpay BNPL: 6%+30¢ | |
| Cash/check: free | |
| Bitcoin: 0% until 2027 | |
| International cards: +1.50% on top | |
| Square Payments, POS, Online, Invoices, Subscriptions APIs | |
| Square Reader/Stand/Terminal/Register hardware | |
| Webhooks for transactions, customers, orders | |
| OAuth 2.0 + Personal access tokens | |
| Catalog API for items, categories, taxes, modifiers | |
| Customer Directory API |
| Name | Description |
|---|---|
| Accept Payments Online | |
| Build Custom POS Systems | |
| Manage Product Catalogs | |
| Track Inventory Across Locations | |
| Create Loyalty and Rewards Programs | |
| Send and Manage Invoices | |
| Schedule Appointments and Bookings | |
| Manage Team Members and Labor | |
| Process Refunds and Disputes | |
| Sell Gift Cards | |
| Set Up Recurring Subscriptions |
| Name | Description |
|---|---|
| Apple Pay | |
| Google Pay | |
| Cash App Pay | |
| Afterpay | |
| QuickBooks | |
| WooCommerce | |
| Wix | |
| BigCommerce |
Machine-readable API specifications organized by format.
- catalog-item-structure.json
- customer-structure.json
- location-structure.json
- money-structure.json
- order-structure.json
- payment-structure.json
- subscription-structure.json
- catalog-item-example.json
- customer-example.json
- location-example.json
- money-example.json
- order-example.json
- payment-example.json
- subscription-example.json
Self-contained Naftiko capabilities, one per Square business surface (OpenAPI tag). Each file inlines its upstream consumes block plus REST and MCP exposers.
- square-mobileauthorization.yaml — 1 operations
- square-payments.yaml — 7 operations
- square-orders.yaml — 8 operations
- square-transactions.yaml — 4 operations
- square-v1transactions.yaml — 3 operations
- square-catalog.yaml — 14 operations
- square-inventory.yaml — 13 operations
- square-customers.yaml — 14 operations
- square-locations.yaml — 4 operations
- square-employees.yaml — 2 operations
- square-team.yaml — 12 operations
- square-labor.yaml — 16 operations
- square-bookings.yaml — 13 operations
- square-loyalty.yaml — 18 operations
- square-giftcards.yaml — 7 operations
- square-invoices.yaml — 10 operations
- square-subscriptions.yaml — 12 operations
- square-checkout.yaml — 10 operations
- square-terminal.yaml — 15 operations
- square-refunds.yaml — 3 operations
- square-disputes.yaml — 9 operations
- square-merchants.yaml — 2 operations
- square-cards.yaml — 4 operations
- square-vendors.yaml — 7 operations
- square-cashdrawers.yaml — 3 operations
- square-bankaccounts.yaml — 3 operations
- square-payouts.yaml — 3 operations
- square-applepay.yaml — 1 operations
- square-sites.yaml — 1 operations
- square-snippets.yaml — 3 operations
- square-oauth.yaml — 3 operations
- square-webhooksubscriptions.yaml — 8 operations
- square-events.yaml — 4 operations
- square-devices.yaml — 5 operations
- square-customergroups.yaml — 5 operations
- square-customersegments.yaml — 2 operations
- square-giftcardactivities.yaml — 2 operations
- square-bookingcustomattributes.yaml — 11 operations
- square-customercustomattributes.yaml — 10 operations
- square-locationcustomattributes.yaml — 11 operations
- square-merchantcustomattributes.yaml — 11 operations
- square-ordercustomattributes.yaml — 11 operations
- Square Vocabulary — Unified taxonomy mapping 42 resources, 42 actions, 42 workflows, and 4 personas across operational (OpenAPI) and capability (Naftiko) dimensions
- Square Spectral Ruleset — 28 rules enforcing Square Connect API conventions
FN: Kin Lane
Email: kin@apievangelist.com