square — quality + safety report

Name: square — quality + safety report
Item: square
Rating: 90
Author: Skillproof

In the Skillier index (lap__squareup-com-square) · scanned 2026-06-03 · engine: builtin+triage

Quality

90/100

Safety

✓ Clean — no heuristic safety flags surfaced.

Heuristic flags from the builtin scanner, which is known to over-flag (it trips on legitimate env-reading integrations, security skills, and library .eval calls). This is NOT an authoritative malicious verdict — re-scan with SkillSpector for the authoritative result. Run the authoritative scan →

📇 This skill is in the Skillier index (curated · deduped · quality-filtered). Install Skillier to route & load it into your AI client.

Quality notes

Skill is large (~11804 tokens)

medium · quality · body

→ Tighten to the essential procedure; move long reference material to linked files.

No example

low · quality · body

→ Add at least one worked example (input → expected action/output).

About this skill

Square API skill. Use when working with Square for mobile, oauth2, {location id}. Covers 327 endpoints.

📄 Read the SKILL.md

---
name: square
description: "Square API skill. Use when working with Square for mobile, oauth2, {location_id}. Covers 327 endpoints."
version: 1.0.0
generator: lapsh
---

# Square
API version: 2.0

## Auth
OAuth2 | ApiKey Authorization in header

## Base URL
https://connect.squareup.com

## Setup
1. Set your API key in the appropriate header
2. GET /v2/bank-accounts -- verify access
3. POST /mobile/authorization-code -- create first authorization-code

## Endpoints

327 endpoints across 34 groups. See references/api-spec.lap for full details.

### mobile
| Method | Path | Description |
|--------|------|-------------|
| POST | /mobile/authorization-code | CreateMobileAuthorizationCode |

### oauth2
| Method | Path | Description |
|--------|------|-------------|
| POST | /oauth2/revoke | RevokeToken |
| POST | /oauth2/token | ObtainToken |
| POST | /oauth2/token/status | RetrieveTokenStatus |

### {location_id}
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/{location_id}/orders | V1ListOrders |
| GET | /v1/{location_id}/orders/{order_id} | V1RetrieveOrder |
| PUT | /v1/{location_id}/orders/{order_id} | V1UpdateOrder |

### apple-pay
| Method | Path | Description |
|--------|------|-------------|
| POST | /v2/apple-pay/domains | RegisterDomain |

### bank-accounts
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/bank-accounts | ListBankAccounts |
| GET | /v2/bank-accounts/by-v1-id/{v1_bank_account_id} | GetBankAccountByV1Id |
| GET | /v2/bank-accounts/{bank_account_id} | GetBankAccount |

### bookings
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/bookings | ListBookings |
| POST | /v2/bookings | CreateBooking |
| POST | /v2/bookings/availability/search | SearchAvailability |
| POST | /v2/bookings/bulk-retrieve | BulkRetrieveBookings |
| GET | /v2/bookings/business-booking-profile | RetrieveBusinessBookingProfile |
| GET | /v2/bookings/custom-attribute-definitions | ListBookingCustomAttributeDefinitions |
| POST | /v2/bookings/custom-attribute-definitions | CreateBookingCustomAttributeDefinition |
| DELETE | /v2/bookings/custom-attribute-definitions/{key} | DeleteBookingCustomAttributeDefinition |
| GET | /v2/bookings/custom-attribute-definitions/{key} | RetrieveBookingCustomAttributeDefinition |
| PUT | /v2/bookings/custom-attribute-definitions/{key} | UpdateBookingCustomAttributeDefinition |
| POST | /v2/bookings/custom-attributes/bulk-delete | BulkDeleteBookingCustomAttributes |
| POST | /v2/bookings/custom-attributes/bulk-upsert | BulkUpsertBookingCustomAttributes |
| GET | /v2/bookings/location-booking-profiles | ListLocationBookingProfiles |
| GET | /v2/bookings/location-booking-profiles/{location_id} | RetrieveLocationBookingProfile |
| GET | /v2/bookings/team-member-booking-profiles | ListTeamMemberBookingProfiles |
| POST | /v2/bookings/team-member-booking-profiles/bulk-retrieve | BulkRetrieveTeamMemberBookingProfiles |
| GET | /v2/bookings/team-member-booking-profiles/{team_member_id} | RetrieveTeamMemberBookingProfile |
| GET | /v2/bookings/{booking_id} | RetrieveBooking |
| PUT | /v2/bookings/{booking_id} | UpdateBooking |
| POST | /v2/bookings/{booking_id}/cancel | CancelBooking |
| GET | /v2/bookings/{booking_id}/custom-attributes | ListBookingCustomAttributes |
| DELETE | /v2/bookings/{booking_id}/custom-attributes/{key} | DeleteBookingCustomAttribute |
| GET | /v2/bookings/{booking_id}/custom-attributes/{key} | RetrieveBookingCustomAttribute |
| PUT | /v2/bookings/{booking_id}/custom-attributes/{key} | UpsertBookingCustomAttribute |

### cards
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/cards | ListCards |
| POST | /v2/cards | CreateCard |
| GET | /v2/cards/{card_id} | RetrieveCard |
| POST | /v2/cards/{card_id}/disable | DisableCard |

### cash-drawers
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/cash-drawers/shifts | ListCashDrawerShifts |
| GET | /v2/cash-drawers/shifts/{shift_id} | RetrieveCashDrawerShift |
| GET | /v2/cash-drawers/shifts/{shift_id}/events | ListCashDrawerShiftEvents |

### catalog
| Method | Path | Description |
|--------|------|-------------|
| POST | /v2/catalog/batch-delete | BatchDeleteCatalogObjects |
| POST | /v2/catalog/batch-retrieve | BatchRetrieveCatalogObjects |
| POST | /v2/catalog/batch-upsert | BatchUpsertCatalogObjects |
| POST | /v2/catalog/images | CreateCatalogImage |
| PUT | /v2/catalog/images/{image_id} | UpdateCatalogImage |
| GET | /v2/catalog/info | CatalogInfo |
| GET | /v2/catalog/list | ListCatalog |
| POST | /v2/catalog/object | UpsertCatalogObject |
| DELETE | /v2/catalog/object/{object_id} | DeleteCatalogObject |
| GET | /v2/catalog/object/{object_id} | RetrieveCatalogObject |
| POST | /v2/catalog/search | SearchCatalogObjects |
| POST | /v2/catalog/search-catalog-items | SearchCatalogItems |
| POST | /v2/catalog/update-item-modifier-lists | UpdateItemModifierLists |
| POST | /v2/catalog/update-item-taxes | UpdateItemTaxes |

### channels
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/channels | ListChannels |
| POST | /v2/channels/bulk-retrieve | BulkRetrieveChannels |
| GET | /v2/channels/{channel_id} | RetrieveChannel |

### customers
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/customers | ListCustomers |
| POST | /v2/customers | CreateCustomer |
| POST | /v2/customers/bulk-create | BulkCreateCustomers |
| POST | /v2/customers/bulk-delete | BulkDeleteCustomers |
| POST | /v2/customers/bulk-retrieve | BulkRetrieveCustomers |
| POST | /v2/customers/bulk-update | BulkUpdateCustomers |
| GET | /v2/customers/custom-attribute-definitions | ListCustomerCustomAttributeDefinitions |
| POST | /v2/customers/custom-attribute-definitions | CreateCustomerCustomAttributeDefinition |
| DELETE | /v2/customers/custom-attribute-definitions/{key} | DeleteCustomerCustomAttributeDefinition |
| GET | /v2/customers/custom-attribute-definitions/{key} | RetrieveCustomerCustomAttributeDefinition |
| PUT | /v2/customers/custom-attribute-definitions/{key} | UpdateCustomerCustomAttributeDefinition |
| POST | /v2/customers/custom-attributes/bulk-upsert | BulkUpsertCustomerCustomAttributes |
| GET | /v2/customers/groups | ListCustomerGroups |
| POST | /v2/customers/groups | CreateCustomerGroup |
| DELETE | /v2/customers/groups/{group_id} | DeleteCustomerGroup |
| GET | /v2/customers/groups/{group_id} | RetrieveCustomerGroup |
| PUT | /v2/customers/groups/{group_id} | UpdateCustomerGroup |
| POST | /v2/customers/search | SearchCustomers |
| GET | /v2/customers/segments | ListCustomerSegments |
| GET | /v2/customers/segments/{segment_id} | RetrieveCustomerSegment |
| DELETE | /v2/customers/{customer_id} | DeleteCustomer |
| GET | /v2/customers/{customer_id} | RetrieveCustomer |
| PUT | /v2/customers/{customer_id} | UpdateCustomer |
| POST | /v2/customers/{customer_id}/cards | CreateCustomerCard |
| DELETE | /v2/customers/{customer_id}/cards/{card_id} | DeleteCustomerCard |
| GET | /v2/customers/{customer_id}/custom-attributes | ListCustomerCustomAttributes |
| DELETE | /v2/customers/{customer_id}/custom-attributes/{key} | DeleteCustomerCustomAttribute |
| GET | /v2/customers/{customer_id}/custom-attributes/{key} | RetrieveCustomerCustomAttribute |
| POST | /v2/customers/{customer_id}/custom-attributes/{key} | UpsertCustomerCustomAttribute |
| DELETE | /v2/customers/{customer_id}/groups/{group_id} | RemoveGroupFromCustomer |
| PUT | /v2/customers/{customer_id}/groups/{group_id} | AddGroupToCustomer |

### devices
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/devices | ListDevices |
| GET | /v2/devices/codes | ListDeviceCodes |
| POST | /v2/devices/codes | CreateDeviceCode |
| GET | /v2/devices/codes/{id} | GetDeviceCode |
| GET | /v2/devices/{device_id} | GetDevice |

### disputes
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/disputes | ListDisputes |
| GET | /v2/disputes/{dispute_id} | RetrieveDispute |
| POST | /v2/disputes/{dispute_id}/accept | AcceptDispute |
| GET | /v2/disputes/{dispute_id}/evidence | ListDisputeEvidence |
| POST | /v2/disputes/{dispute_id}/evidence-files | CreateDisputeEvidenceFile |
| POST | /v2/disputes/{dispute_id}/evidence-text | CreateDisputeEvidenceText |
| DELETE | /v2/disputes/{dispute_id}/evidence/{evidence_id} | DeleteDisputeEvidence |
| GET | /v2/disputes/{dispute_id}/evidence/{evidence_id} | RetrieveDisputeEvidence |
| POST | /v2/disputes/{dispute_id}/submit-evidence | SubmitEvidence |

### employees
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/employees | ListEmployees |
| GET | /v2/employees/{id} | RetrieveEmployee |

### events
| Method | Path | Description |
|--------|------|-------------|
| POST | /v2/events | SearchEvents |
| PUT | /v2/events/disable | DisableEvents |
| PUT | /v2/events/enable | EnableEvents |
| GET | /v2/events/types | ListEventTypes |

### gift-cards
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/gift-cards | ListGiftCards |
| POST | /v2/gift-cards | CreateGiftCard |
| GET | /v2/gift-cards/activities | ListGiftCardActivities |
| POST | /v2/gift-cards/activities | CreateGiftCardActivity |
| POST | /v2/gift-cards/from-gan | RetrieveGiftCardFromGAN |
| POST | /v2/gift-cards/from-nonce | RetrieveGiftCardFromNonce |
| POST | /v2/gift-cards/{gift_card_id}/link-customer | LinkCustomerToGiftCard |
| POST | /v2/gift-cards/{gift_card_id}/unlink-customer | UnlinkCustomerFromGiftCard |
| GET | /v2/gift-cards/{id} | RetrieveGiftCard |

### inventory
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/inventory/adjustment/{adjustment_id} | DeprecatedRetrieveInventoryAdjustment |
| GET | /v2/inventory/adjustments/{adjustment_id} | RetrieveInventoryAdjustment |
| POST | /v2/inventory/batch-change | DeprecatedBatchChangeInventory |
| POST | /v2/inventory/batch-retrieve-changes | DeprecatedBatchRetrieveInventoryChanges |
| POST | /v2/inventory/batch-retrieve-counts | DeprecatedBatchRetrieveInventoryCounts |
| POST | /v2/inventory/changes/batch-create | BatchChangeInventory |
| POST | /v2/inventory/changes/batch-retrieve | BatchRetrieveInventoryChanges |
| POST | /v2/inventory/counts/batch-retrieve | BatchRetrieveInventoryCounts |
| GET | /v2/inventory/physical-count/{physical_count_id} | DeprecatedRetrieveInventoryPhysicalCount |
| GET | /v2/inventory/physical-counts/{physical_count_id} | RetrieveInventoryPhysicalCount |
| GET | /v2/inventory/transfers/{transfer_id} | RetrieveInventoryTransfer |
| GET | /v2/inventory/{catalog_object_id} | RetrieveInventoryCount |
| GET | /v2/inventory/{catalog_object_id}/changes | RetrieveInventoryChanges |

### invoices
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/invoices | ListInvoices |
| POST | /v2/invoices | CreateInvoice |
| POST | /v2/invoices/search | SearchInvoices |
| DELETE | /v2/invoices/{invoice_id} | DeleteInvoice |
| GET | /v2/invoices/{invoice_id} | GetInvoice |
| PUT | /v2/invoices/{invoice_id} | UpdateInvoice |
| POST | /v2/invoices/{invoice_id}/attachments | CreateInvoiceAttachment |
| DELETE | /v2/invoices/{invoice_id}/attachments/{attachment_id} | DeleteInvoiceAttachment |
| POST | /v2/invoices/{invoice_id}/cancel | CancelInvoice |
| POST | /v2/invoices/{invoice_id}/publish | PublishInvoice |

### labor
| Method | Path | Description |
|--------|------|-------------|
| GET | /v2/labor/break-types | ListBreakTypes |
| POST | /v2/labor/break-types | CreateBreakType |
| DELETE | /v2/labor/break-types/{id} | DeleteBreakType |
| GET | /v2/labor/break-types/{id} | GetBreakType |
| PUT | /v2/labor/break-types/{id} | UpdateBreakType |
| GET | /v2/labor/employee-wages | ListEmployeeWages |
| GET | /v2/labor/employee-wages/{id} | GetEmployeeWage |
| POST | /v2/labor/scheduled-shifts | CreateScheduledShift |
| POST | /v2/labor/scheduled-shifts/bulk-publish | BulkPublishSched

… (truncated)

Scan or optimize your own skill →

Want a live grade + an embeddable README badge? Run your skill through the free scanner.

Graded independently by Skillproof — nothing to sell the author. Quality is mechanical + corpus-grounded; safety flags are heuristic (builtin+triage), not a malicious verdict.