PayPal website screenshot

PayPal

PayPal is a global online payment system that lets individuals and businesses send and receive money electronically. PayPal exposes a broad surface of REST APIs covering payments, orders, subscriptions, invoicing, payouts, disputes, payment tokens, shipping tracking, transaction reporting, partner referrals, payment experience, and webhook notifications.

PayPal publishes 37 APIs on the APIs.io network, including Activate API, Authorizations API, Balances API, and 34 more. Tagged areas include Billing, Commerce, Disputes, Invoices, and Orders.

The PayPal catalog on APIs.io includes 1 Spectral governance ruleset.

PayPal’s developer surface includes sandbox, changelog, authentication, documentation, pricing, engineering blog, and 19 more developer resources.

62.7/100 strong ▬ flat Agent 41/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessPaidSelf serve
37 APIs 16 Features
BillingCommerceDisputesInvoicesOrdersPaymentsPayoutsSubscriptionsTokensWebhooks

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 62.7/100 · strong
Contract Quality 15.5 / 25
Developer Ergonomics 8.3 / 20
Commercial Clarity 15.8 / 20
Operational Transparency 8.9 / 13
Governance 7.0 / 12
Discoverability 5.9 / 10
Agent readiness — 41/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/paypal: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 37

Individual APIs this provider publishes, each with its own machine-readable definition.

PayPal Activate API

The Activate API from PayPal — 2 operation(s) for activate.

PayPal Authorizations API

Use the `/authorizations` resource to show details for, capture payment for, reauthorize, and void authorized payments.

PayPal Balances API

Use the `/balances` resource to list balances.

PayPal Billing API

The Billing API from PayPal — 13 operation(s) for billing.

PayPal Cancel API

The Cancel API from PayPal — 1 operation(s) for cancel.

PayPal Capture API

The Capture API from PayPal — 1 operation(s) for capture.

PayPal Captures API

Use the `/captures` resource to show details for and refund a captured payment.

PayPal Deactivate API

The Deactivate API from PayPal — 1 operation(s) for deactivate.

PayPal Disputes-Actions API

Use the `/disputes` resource with a dispute ID and an action to:

  • Accept a claim.
  • Accept an offer to resolve a dispute.
  • Acknowledge the return of an item r...

PayPal Disputes API

Use the `/disputes` resource to list disputes, create disputes, show dispute details, and partially a dispute. Normally, an agent at PayPal creates disputes but now you can run ...

PayPal Invoices API

Use the `/invoices` resource to create, update, and send invoices and invoice reminders. To manage invoices, you can also list invoices, show details for invoices, delete draft ...

PayPal Orders API

Use the `/orders` resource to create, update, retrieve, authorize, capture and track orders.

PayPal Partner-Referrals API

Enables you to create and get information about shared customer data.

PayPal Payment-Tokens API

Use the `/vault/payment-tokens` resource to create, retrieve, and delete a payment token that may optionally be associated with a customer.

PayPal Payouts API

Use the `/payouts` resource to create a batch payout, update the status for a batch payout, show the status of a batch payout with the transaction status and other data for indi...

PayPal Payouts-Item API

Use the `/payouts-item` resource to show payout item details and cancel an unclaimed payout item.

PayPal Plans API

The Plans API from PayPal — 5 operation(s) for plans.

PayPal Pricing API

The Pricing API from PayPal — 1 operation(s) for pricing.

PayPal Products API

Use `/products` resource to create and manage products.

PayPal Refunds API

Use the `/refunds` resource to show refund details.

PayPal Revise API

The Revise API from PayPal — 1 operation(s) for revise.

PayPal Schemes API

The Schemes API from PayPal — 1 operation(s) for schemes.

PayPal Search-Invoices API

Use the `/search-invoices` resource to search for and list invoices that match search criteria.

PayPal Setup-Tokens API

Use the `/vault/setup-tokens` resource to create and retrieve temporary vault payment methods.

PayPal Simulate-Event API

Use the `/simulate-event` resource to use a sample payload to simulate a webhook event. The events that this call generates only serve to validate the connection to the listener...

PayPal Subscriptions API

The Subscriptions API from PayPal — 8 operation(s) for subscriptions.

PayPal Suspend API

The Suspend API from PayPal — 1 operation(s) for suspend.

PayPal Templates API

Use the `/templates` resource to create, list, show details for, update, and delete invoice templates. Use the `/templates` resource when you create a third-party invoicing appl...

PayPal Trackers API

Use the `/trackers` resource to update and retrieve tracking information for PayPal orders.

PayPal Trackers-Batch API

Use the `/trackers-batch` resource to add tracking information for multiple PayPal transactions.

PayPal Transactions API

The Transactions API from PayPal — 2 operation(s) for transactions.

PayPal Verify-Webhook-Signature API

Use the `/verify-webhook-signature` resource to verify a webhook signature.

PayPal Web-Profiles API

Use the `/payment-experience/web-profiles` resource to create, show details for, list, update, partially update, and delete web experience profiles.

PayPal Webhooks API

Use the `/webhooks` resource to subscribe your webhook listener to events, list webhooks for an app, show details for, update, delete, and list event subscriptions for webhooks.

PayPal Webhooks-Event-Types API

Use the `/webhooks-event-types` resource to list available events to which any webhook can subscribe.

PayPal Webhooks-Events API

Use the `/webhooks-events` resource to list, show details for, and resend event notifications.

PayPal Webhooks-Lookup API

Use the `/webhooks-lookup` resource to create, list, show details for, and delete webhook lookups.

Scroll for all 37

Postman Collections 37

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 37

GraphQL 1

GraphQL schemas published by this provider.

PayPal GraphQL Schema

This conceptual GraphQL schema represents the PayPal payments platform surface, covering REST APIs for Orders, Payments, Payouts, Subscriptions, Invoicing, Reporting, Disputes, ...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Paypal Plans Pricing

7 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Paypal Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 16

Notable capabilities this provider offers.

PayPal Checkout: 3.49% + $0.49 per transaction
Standard Credit/Debit Card: 2.99% + $0.49
QR Code Transactions: 2.29% + $0.09
POS Card Present: 2.29% + $0.09
POS Manual Entry: 3.49% + $0.09
Invoicing ACH: 1% (capped $10)
International transactions: +1.50% surcharge
200+ markets, 25 currencies
REST API at api-m.paypal.com
OAuth 2.0 client credentials
Sandbox at 20 req/min for testing
Webhooks for payment events (signed)
Smart Payment Buttons (JS SDK)
Hosted Card Fields and Advanced Credit/Debit Card
Subscriptions and Recurring Billing
Buyer and Seller Protection programs

Scroll for all 16

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

PayPal API Rules

5 rules · 4 warnings 1 info

SPECTRAL

JSON Schema 576

Standalone JSON Schema definitions for this provider's data models.

Accepted Response

1 properties

JSON SCHEMA

3ds_result

0 properties

JSON SCHEMA

400

1 properties

JSON SCHEMA

401

1 properties

JSON SCHEMA

403

1 properties

JSON SCHEMA

404

1 properties

JSON SCHEMA

409

1 properties

JSON SCHEMA

422

1 properties

JSON SCHEMA

Accept Claim Response Options

1 properties

JSON SCHEMA

Accept Claim Type

0 properties

JSON SCHEMA

Accept Offer Request

1 properties

JSON SCHEMA

account_id-2

0 properties

JSON SCHEMA

PayPal Account Identifier

0 properties

JSON SCHEMA

Account

2 properties

JSON SCHEMA

ACH Debit Response

0 properties

JSON SCHEMA

ach_debit_response

0 properties

JSON SCHEMA

ach_debit_verification_status

0 properties

JSON SCHEMA

Allowed Acknowledgement Type

0 properties

JSON SCHEMA

Evidence Extensions

3 properties

JSON SCHEMA

Transaction Date and Time Stamps

2 properties

JSON SCHEMA

address_entity

0 properties

JSON SCHEMA

Settle Request

1 properties

JSON SCHEMA

adjudication_reason

0 properties

JSON SCHEMA

Adjudication

4 properties

JSON SCHEMA

adjudication_type

0 properties

JSON SCHEMA

Aggregated Discount

2 properties

JSON SCHEMA

Agreed Refund Details

2 properties

JSON SCHEMA

Allowed Response Options

3 properties

JSON SCHEMA

Alternate Notification Method

1 properties

JSON SCHEMA

altpay_recurring_attributes_request

0 properties

JSON SCHEMA

altpay_recurring_attributes

0 properties

JSON SCHEMA

Amount Breakdown

7 properties

JSON SCHEMA

Amount Range

2 properties

JSON SCHEMA

Invoice Amount Summary

3 properties

JSON SCHEMA

Amount with Breakdown

6 properties

JSON SCHEMA

apple_pay_attributes

0 properties

JSON SCHEMA

Apple Pay Card

0 properties

JSON SCHEMA

Decrypted Apple Pay Token data.

5 properties

JSON SCHEMA

Apple Pay Response

1 properties

JSON SCHEMA

ApplePay payment request object

8 properties

JSON SCHEMA

Application Context

7 properties

JSON SCHEMA

Auction Information

4 properties

JSON SCHEMA

authentication_flow

0 properties

JSON SCHEMA

Authentication Response

2 properties

JSON SCHEMA

Authorization

0 properties

JSON SCHEMA

Authorization

0 properties

JSON SCHEMA

Auhorization Status Details

1 properties

JSON SCHEMA

Authorization Status

2 properties

JSON SCHEMA

Authorization with Additional Data

0 properties

JSON SCHEMA

authorizations.reauthorize-400

1 properties

JSON SCHEMA

authorizations.reauthorize-422

1 properties

JSON SCHEMA

authorizations.void-422

1 properties

JSON SCHEMA

Balance Information

5 properties

JSON SCHEMA

Balances Response

4 properties

JSON SCHEMA

Bancontact payment object

4 properties

JSON SCHEMA

Bancontact payment object

6 properties

JSON SCHEMA

Bank Response

1 properties

JSON SCHEMA

Bank Account

7 properties

JSON SCHEMA

Batch status

0 properties

JSON SCHEMA

Batch Tracker Collection

3 properties

JSON SCHEMA

Beneficial_owners

2 properties

JSON SCHEMA

BIC

0 properties

JSON SCHEMA

billing_agreement_id

0 properties

JSON SCHEMA

Billing Agreement

5 properties

JSON SCHEMA

Billing Cycle Override

3 properties

JSON SCHEMA

Billing Cycle

5 properties

JSON SCHEMA

Billing Disputes Properties

5 properties

JSON SCHEMA

Billing Experience Preference

2 properties

JSON SCHEMA

Billing Information

0 properties

JSON SCHEMA

Bin Details

4 properties

JSON SCHEMA

Birth details

1 properties

JSON SCHEMA

BLIK Experience Context

0 properties

JSON SCHEMA

BLIK one-click payment object

1 properties

JSON SCHEMA

BLIK one-click payment object

4 properties

JSON SCHEMA

BLIK payment object

6 properties

JSON SCHEMA

BLIK payment object

4 properties

JSON SCHEMA

BLIK level_0 payment object

1 properties

JSON SCHEMA

Business_address_detail

0 properties

JSON SCHEMA

Business address type

0 properties

JSON SCHEMA

Business_beneficial_owner

0 properties

JSON SCHEMA

Business document

0 properties

JSON SCHEMA

Document type

0 properties

JSON SCHEMA

Business_entity

0 properties

JSON SCHEMA

Business_incorporation

3 properties

JSON SCHEMA

Business industry

3 properties

JSON SCHEMA

Business name

0 properties

JSON SCHEMA

Business Name

1 properties

JSON SCHEMA

The business name type.

0 properties

JSON SCHEMA

Phone details

0 properties

JSON SCHEMA

Phone type

0 properties

JSON SCHEMA

business

9 properties

JSON SCHEMA

The business sub type.

0 properties

JSON SCHEMA

Business type information

2 properties

JSON SCHEMA

Business type

0 properties

JSON SCHEMA

buyer_escalation_reason

0 properties

JSON SCHEMA

Customer

1 properties

JSON SCHEMA

Canceled Recurring Billing

2 properties

JSON SCHEMA

Cancellation Details

4 properties

JSON SCHEMA

Capability

0 properties

JSON SCHEMA

Capture

0 properties

JSON SCHEMA

Capture Request

0 properties

JSON SCHEMA

Capture

0 properties

JSON SCHEMA

Capture Status Details

1 properties

JSON SCHEMA

Capture Status

2 properties

JSON SCHEMA

captures.refund-400

1 properties

JSON SCHEMA

captures.refund-422

1 properties

JSON SCHEMA

Card Attributes Response

1 properties

JSON SCHEMA

Card Attributes

2 properties

JSON SCHEMA

Card Brand

0 properties

JSON SCHEMA

Card Experience Context

2 properties

JSON SCHEMA

Response of Card from Request

2 properties

JSON SCHEMA

Card Request

0 properties

JSON SCHEMA

Card Response

4 properties

JSON SCHEMA

Card

8 properties

JSON SCHEMA

Card Stored Credential

4 properties

JSON SCHEMA

Card Supplementary Data

2 properties

JSON SCHEMA

Card Type

0 properties

JSON SCHEMA

Card Verification Details

5 properties

JSON SCHEMA

Card Verification Method

0 properties

JSON SCHEMA

Card Verification Status

0 properties

JSON SCHEMA

Carrier

0 properties

JSON SCHEMA

Cart Information

3 properties

JSON SCHEMA

Checkout Option

2 properties

JSON SCHEMA

Checkout Payment Intent

0 properties

JSON SCHEMA

CLASSIC API integration

0 properties

JSON SCHEMA

cobranded card object

3 properties

JSON SCHEMA

Contact Details

3 properties

JSON SCHEMA

Configuration

0 properties

JSON SCHEMA

Confirm Order Request

3 properties

JSON SCHEMA

Contact Information

0 properties

JSON SCHEMA

country_code-2

0 properties

JSON SCHEMA

country_code

0 properties

JSON SCHEMA

Create Payout Request

2 properties

JSON SCHEMA

Create Referral Data Response

1 properties

JSON SCHEMA

Credit Not Processed

6 properties

JSON SCHEMA

cryptocurrency_quantity

0 properties

JSON SCHEMA

Cryptocurrency

2 properties

JSON SCHEMA

cryptocurrency_symbol

0 properties

JSON SCHEMA

currency_code-2

0 properties

JSON SCHEMA

currency_code

0 properties

JSON SCHEMA

Currency Range

2 properties

JSON SCHEMA

Currency

2 properties

JSON SCHEMA

Custom Amount

2 properties

JSON SCHEMA

Vault of a customer

5 properties

JSON SCHEMA

Billing Cycle Execution Details

6 properties

JSON SCHEMA

date_no_time

0 properties

JSON SCHEMA

Date Range

2 properties

JSON SCHEMA

Date and Time Range

2 properties

JSON SCHEMA

date_time

0 properties

JSON SCHEMA

date_year_month

0 properties

JSON SCHEMA

Deny Offer Request

1 properties

JSON SCHEMA

dependent_process

0 properties

JSON SCHEMA

Invoice_Detail

6 properties

JSON SCHEMA

Disbursement Mode

0 properties

JSON SCHEMA

Discount

2 properties

JSON SCHEMA

dispute_channel

0 properties

JSON SCHEMA

Dispute Summary Information

13 properties

JSON SCHEMA

dispute_lifecycle_stage

0 properties

JSON SCHEMA

Dispute Outcome

3 properties

JSON SCHEMA

Dispute Reason

0 properties

JSON SCHEMA

Dispute Details

26 properties

JSON SCHEMA

Dispute Search Response

2 properties

JSON SCHEMA

Dispute State

0 properties

JSON SCHEMA

Document

2 properties

JSON SCHEMA

Duplicate Transaction

2 properties

JSON SCHEMA

eci_flag

0 properties

JSON SCHEMA

email_address

0 properties

JSON SCHEMA

email

0 properties

JSON SCHEMA

enrolled

0 properties

JSON SCHEMA

An eps payment object

3 properties

JSON SCHEMA

An eps payment object

3 properties

JSON SCHEMA

Bad Request Error

5 properties

JSON SCHEMA

Unauthorized Error

5 properties

JSON SCHEMA

Not Authorized Error

5 properties

JSON SCHEMA

Not found Error

5 properties

JSON SCHEMA

Resource Conflict Error

5 properties

JSON SCHEMA

Unsupported Media Type Error

5 properties

JSON SCHEMA

Unprocessable Entity Error

5 properties

JSON SCHEMA

Internal Server Error

4 properties

JSON SCHEMA

Service Unavailable Error

4 properties

JSON SCHEMA

error_default

0 properties

JSON SCHEMA

Error Details

5 properties

JSON SCHEMA

Error Details

5 properties

JSON SCHEMA

Link Description

3 properties

JSON SCHEMA

error_location

0 properties

JSON SCHEMA

Error

6 properties

JSON SCHEMA

Escalate Claim Request

2 properties

JSON SCHEMA

Event Resend

1 properties

JSON SCHEMA

Event

9 properties

JSON SCHEMA

Event Type

4 properties

JSON SCHEMA

Event Version

0 properties

JSON SCHEMA

Event List

3 properties

JSON SCHEMA

Event Type List

1 properties

JSON SCHEMA

Evidence Information

2 properties

JSON SCHEMA

Evidence

10 properties

JSON SCHEMA

Exchange Rate

3 properties

JSON SCHEMA

exemption_details

0 properties

JSON SCHEMA

Experience Context

5 properties

JSON SCHEMA

Experience Context

6 properties

JSON SCHEMA

Extensions

8 properties

JSON SCHEMA

Failed Payment Details

4 properties

JSON SCHEMA

Fee Policy

0 properties

JSON SCHEMA

File Reference

5 properties

JSON SCHEMA

Financial instrument.

1 properties

JSON SCHEMA

Billing Cycle Frequency

2 properties

JSON SCHEMA

full_name

0 properties

JSON SCHEMA

Funding source

0 properties

JSON SCHEMA

A giropay payment object

3 properties

JSON SCHEMA

A giropay payment object

3 properties

JSON SCHEMA

google_pay_request

0 properties

JSON SCHEMA

iban_last_chars

0 properties

JSON SCHEMA

The iDEAL payment object

5 properties

JSON SCHEMA

The iDEAL payment object

5 properties

JSON SCHEMA

Bank Account Identifier

2 properties

JSON SCHEMA

Incentive Details

4 properties

JSON SCHEMA

Incentive Information

1 properties

JSON SCHEMA

Incorrect Transaction Amount

3 properties

JSON SCHEMA

Individual_beneficial_owner

0 properties

JSON SCHEMA

Individual_owner

0 properties

JSON SCHEMA

Individual owner role type

0 properties

JSON SCHEMA

instrument_id

0 properties

JSON SCHEMA

Integration Details

2 properties

JSON SCHEMA

Invoice Creation Flow

0 properties

JSON SCHEMA

Invoice Detail

0 properties

JSON SCHEMA

Invoice Number

1 properties

JSON SCHEMA

Invoice Payment Term

0 properties

JSON SCHEMA

Invoice

15 properties

JSON SCHEMA

Invoice Status

0 properties

JSON SCHEMA

Invoicer Information

0 properties

JSON SCHEMA

Invoices

4 properties

JSON SCHEMA

invoices.cancel-400

1 properties

JSON SCHEMA

invoices.cancel-422

1 properties

JSON SCHEMA

invoices.create-400

1 properties

JSON SCHEMA

invoices.generate-qr-code-400

1 properties

JSON SCHEMA

invoices.payments-400

1 properties

JSON SCHEMA

invoices.payments-422

1 properties

JSON SCHEMA

invoices.payments-delete-422

1 properties

JSON SCHEMA

invoices.refunds-400

1 properties

JSON SCHEMA

invoices.refunds-422

1 properties

JSON SCHEMA

invoices.remind-400

1 properties

JSON SCHEMA

invoices.remind-422

1 properties

JSON SCHEMA

invoices.search-invoices-400

1 properties

JSON SCHEMA

invoices.update-400

1 properties

JSON SCHEMA

IP Address

0 properties

JSON SCHEMA

item_agreed_refund_details

0 properties

JSON SCHEMA

item_booking_details

0 properties

JSON SCHEMA

item_cancellation_details

0 properties

JSON SCHEMA

Item Details

19 properties

JSON SCHEMA

Tax Amount

1 properties

JSON SCHEMA

item_digital_download_details

0 properties

JSON SCHEMA

Item Information

15 properties

JSON SCHEMA

item_product_details

0 properties

JSON SCHEMA

Item

7 properties

JSON SCHEMA

item_service_details

0 properties

JSON SCHEMA

Item Type

0 properties

JSON SCHEMA

language

0 properties

JSON SCHEMA

Last Payment Details

0 properties

JSON SCHEMA

Legal Consent

2 properties

JSON SCHEMA

Level 2 Card Processing Data

2 properties

JSON SCHEMA

Level 3 Card Processing Data

6 properties

JSON SCHEMA

liability_shift

0 properties

JSON SCHEMA

Lineitem

0 properties

JSON SCHEMA

Link Description

3 properties

JSON SCHEMA

Link Description

3 properties

JSON SCHEMA

Make Offer Response Options

1 properties

JSON SCHEMA

Make Offer Request

5 properties

JSON SCHEMA

Mandate

1 properties

JSON SCHEMA

Merchandise Dispute Properties

5 properties

JSON SCHEMA

Merchant Contacted Method

0 properties

JSON SCHEMA

Merchant Contacted Outcome

0 properties

JSON SCHEMA

merchant_partner_customer_id

0 properties

JSON SCHEMA

Message

4 properties

JSON SCHEMA

Metadata

0 properties

JSON SCHEMA

Money

2 properties

JSON SCHEMA

money_movement_reason

0 properties

JSON SCHEMA

Money movement

6 properties

JSON SCHEMA

Money

2 properties

JSON SCHEMA

MyBank payment object

3 properties

JSON SCHEMA

MyBank payment object

4 properties

JSON SCHEMA

Name

6 properties

JSON SCHEMA

Name

7 properties

JSON SCHEMA

Net Amount Breakdown Item

3 properties

JSON SCHEMA

Network Token

5 properties

JSON SCHEMA

Network Transaction Reference

4 properties

JSON SCHEMA

Notification

5 properties

JSON SCHEMA

Offer History

7 properties

JSON SCHEMA

Offer

4 properties

JSON SCHEMA

Offer Type

0 properties

JSON SCHEMA

Role type

0 properties

JSON SCHEMA

Office Bearers

0 properties

JSON SCHEMA

Operation

3 properties

JSON SCHEMA

Application Context

9 properties

JSON SCHEMA

Authorize Request

1 properties

JSON SCHEMA

Order

0 properties

JSON SCHEMA

Order Capture Request

1 properties

JSON SCHEMA

Confirm Application Context

5 properties

JSON SCHEMA

Order Request

5 properties

JSON SCHEMA

Order

0 properties

JSON SCHEMA

Order Status

0 properties

JSON SCHEMA

Order Tracker Request.

0 properties

JSON SCHEMA

orders.authorize-400

1 properties

JSON SCHEMA

orders.authorize-403

1 properties

JSON SCHEMA

orders.authorize-422

1 properties

JSON SCHEMA

orders.capture-400

1 properties

JSON SCHEMA

orders.capture-403

1 properties

JSON SCHEMA

orders.capture-422

1 properties

JSON SCHEMA

orders.confirm-400

1 properties

JSON SCHEMA

orders.confirm-422

1 properties

JSON SCHEMA

orders.patch-400

1 properties

JSON SCHEMA

orders.patch-422

1 properties

JSON SCHEMA

orders.track.create-400

1 properties

JSON SCHEMA

orders.track.create-403

1 properties

JSON SCHEMA

orders.track.create-422

1 properties

JSON SCHEMA

orders.trackers.patch-400

1 properties

JSON SCHEMA

orders.trackers.patch-403

1 properties

JSON SCHEMA

orders.trackers.patch-404

1 properties

JSON SCHEMA

orders.trackers.patch-422

1 properties

JSON SCHEMA

ordinal

0 properties

JSON SCHEMA

P24 payment object

4 properties

JSON SCHEMA

P24 payment object

6 properties

JSON SCHEMA

pares_status

0 properties

JSON SCHEMA

Partial Payment

2 properties

JSON SCHEMA

Partner Configuration Override

5 properties

JSON SCHEMA

Patch Request

0 properties

JSON SCHEMA

Patch

4 properties

JSON SCHEMA

Merchant Base

2 properties

JSON SCHEMA

payee_payment_method_preference

0 properties

JSON SCHEMA

Payee

0 properties

JSON SCHEMA

Payer Base

2 properties

JSON SCHEMA

Payer Information

8 properties

JSON SCHEMA

Customer

0 properties

JSON SCHEMA

Payment by Other Means

4 properties

JSON SCHEMA

Payment Collection

3 properties

JSON SCHEMA

Payment Detail

7 properties

JSON SCHEMA

payment_initiator

0 properties

JSON SCHEMA

Payment Instruction

1 properties

JSON SCHEMA

Payment Instruction

4 properties

JSON SCHEMA

Payment Method

3 properties

JSON SCHEMA

Payment Preferences Override

4 properties

JSON SCHEMA

Payment Preferences

4 properties

JSON SCHEMA

payment_processor

0 properties

JSON SCHEMA

Payment Reference

1 properties

JSON SCHEMA

Payment Source Response

1 properties

JSON SCHEMA

Payment Source

1 properties

JSON SCHEMA

Payment Term

1 properties

JSON SCHEMA

Payment Term Type

0 properties

JSON SCHEMA

Payment Token Request

3 properties

JSON SCHEMA

Payment Token Response

4 properties

JSON SCHEMA

Payment Token Status

0 properties

JSON SCHEMA

Payment Type

0 properties

JSON SCHEMA

Payments

2 properties

JSON SCHEMA

Payout Attributes

3 properties

JSON SCHEMA

Payout Batch Header

9 properties

JSON SCHEMA

Payout Item

11 properties

JSON SCHEMA

Payout Batch

5 properties

JSON SCHEMA

Currency conversion resource

3 properties

JSON SCHEMA

Payout Header

4 properties

JSON SCHEMA

Payout Item

12 properties

JSON SCHEMA

Payout Item Detail

8 properties

JSON SCHEMA

Payout Item

10 properties

JSON SCHEMA

Create Payout Response

2 properties

JSON SCHEMA

Payout Sender Batch Header

4 properties

JSON SCHEMA

PayPal Wallet Attributes Response

2 properties

JSON SCHEMA

PayPal Wallet Attributes

2 properties

JSON SCHEMA

PayPal Wallet Experience Context

8 properties

JSON SCHEMA

PayPal Wallet Request

0 properties

JSON SCHEMA

PayPal Wallet Response

10 properties

JSON SCHEMA

PayPal Wallet

10 properties

JSON SCHEMA

percentage

0 properties

JSON SCHEMA

Person address detail

0 properties

JSON SCHEMA

Person address type

0 properties

JSON SCHEMA

Person document

0 properties

JSON SCHEMA

Document type

0 properties

JSON SCHEMA

Person name

0 properties

JSON SCHEMA

Person name type

0 properties

JSON SCHEMA

Phone details

0 properties

JSON SCHEMA

Person

7 properties

JSON SCHEMA

Phone

1 properties

JSON SCHEMA

Phone Detail

0 properties

JSON SCHEMA

Phone number tag

0 properties

JSON SCHEMA

Phone

3 properties

JSON SCHEMA

Phone Type

0 properties

JSON SCHEMA

Phone Type

0 properties

JSON SCHEMA

Phone With Type

2 properties

JSON SCHEMA

Plan Collection

4 properties

JSON SCHEMA

Plan Override

3 properties

JSON SCHEMA

Create Plan Request

8 properties

JSON SCHEMA

Plan

12 properties

JSON SCHEMA

plans.activate-422

1 properties

JSON SCHEMA

plans.create-400

1 properties

JSON SCHEMA

plans.deactivate-422

1 properties

JSON SCHEMA

plans.patch-400

1 properties

JSON SCHEMA

plans.patch-422

1 properties

JSON SCHEMA

plans.update-pricing-schemes-400

1 properties

JSON SCHEMA

plans.update-pricing-schemes-422

1 properties

JSON SCHEMA

Platform Fee

2 properties

JSON SCHEMA

Pricing Scheme

6 properties

JSON SCHEMA

Pricing Tier

3 properties

JSON SCHEMA

Processing Instruction

0 properties

JSON SCHEMA

Processor Response

4 properties

JSON SCHEMA

Product Category

0 properties

JSON SCHEMA

Product Element

5 properties

JSON SCHEMA

Product Collection

4 properties

JSON SCHEMA

Product Details

7 properties

JSON SCHEMA

Create Product Request

7 properties

JSON SCHEMA

Product Details

10 properties

JSON SCHEMA

products.create-400

1 properties

JSON SCHEMA

products.patch-400

1 properties

JSON SCHEMA

products.patch-422

1 properties

JSON SCHEMA

Purchase Unit Request

11 properties

JSON SCHEMA

Purchase Unit

13 properties

JSON SCHEMA

Purpose Code

0 properties

JSON SCHEMA

Purpose

0 properties

JSON SCHEMA

QR Configuration

3 properties

JSON SCHEMA

Reauthorize Request

1 properties

JSON SCHEMA

Recipient type

0 properties

JSON SCHEMA

Recipient Information

2 properties

JSON SCHEMA

Recipient wallet

0 properties

JSON SCHEMA

Referral Data Response

4 properties

JSON SCHEMA

Customer Data

0 properties

JSON SCHEMA

Refund Detail

5 properties

JSON SCHEMA

Refund Details

1 properties

JSON SCHEMA

Refund Payment Reference

1 properties

JSON SCHEMA

Refund Request

5 properties

JSON SCHEMA

Refund

0 properties

JSON SCHEMA

Refund Status Details

1 properties

JSON SCHEMA

Refund Status

2 properties

JSON SCHEMA

Refunds

2 properties

JSON SCHEMA

Related Identifiers

3 properties

JSON SCHEMA

Require Evidence Request

1 properties

JSON SCHEMA

Resource Version

0 properties

JSON SCHEMA

REST API Integration

4 properties

JSON SCHEMA

REST Endpoint Features

0 properties

JSON SCHEMA

Return Details

5 properties

JSON SCHEMA

Search Data

16 properties

JSON SCHEMA

Search Response

9 properties

JSON SCHEMA

Seller Protection

2 properties

JSON SCHEMA

Seller Receivable Breakdown

7 properties

JSON SCHEMA

Merchant

3 properties

JSON SCHEMA

Sender Batch Header

5 properties

JSON SCHEMA

Service Details

5 properties

JSON SCHEMA

Setup Token

3 properties

JSON SCHEMA

Minimal Setup Token

6 properties

JSON SCHEMA

Carrier.

0 properties

JSON SCHEMA

Shipment Tracker.

14 properties

JSON SCHEMA

Shipment Tracking Number Type.

0 properties

JSON SCHEMA

Shipment Tracking Status.

0 properties

JSON SCHEMA

Shipping Cost

2 properties

JSON SCHEMA

Shipping Details

3 properties

JSON SCHEMA

Shipping Information

4 properties

JSON SCHEMA

Shipping Option

5 properties

JSON SCHEMA

Shipping Type

0 properties

JSON SCHEMA

Order Shipping Details

0 properties

JSON SCHEMA

Simulate Event

4 properties

JSON SCHEMA

Sofort payment object

3 properties

JSON SCHEMA

Sofort payment object

4 properties

JSON SCHEMA

status

0 properties

JSON SCHEMA

store_in_vault_instruction

0 properties

JSON SCHEMA

Store Information

2 properties

JSON SCHEMA

stored_payment_source_payment_type

0 properties

JSON SCHEMA

Stored Payment Source

4 properties

JSON SCHEMA

stored_payment_source_usage_type

0 properties

JSON SCHEMA

Subscriber Request Information

0 properties

JSON SCHEMA

Subscriber Response Information

0 properties

JSON SCHEMA

Activate Subscription Request

1 properties

JSON SCHEMA

Subscription Billing Information

7 properties

JSON SCHEMA

Cancel Subscription Request

1 properties

JSON SCHEMA

Charge Amount from Subscriber

3 properties

JSON SCHEMA

Create Subscription Request

9 properties

JSON SCHEMA

Subscription Modify Plan Request

6 properties

JSON SCHEMA

Subscription

0 properties

JSON SCHEMA

Subscription Status

3 properties

JSON SCHEMA

Suspend Subscription

1 properties

JSON SCHEMA

subscriptions.activate-400

1 properties

JSON SCHEMA

subscriptions.activate-422

1 properties

JSON SCHEMA

subscriptions.cancel-400

1 properties

JSON SCHEMA

subscriptions.cancel-422

1 properties

JSON SCHEMA

subscriptions.capture-400

1 properties

JSON SCHEMA

subscriptions.capture-422

1 properties

JSON SCHEMA

subscriptions.create-400

1 properties

JSON SCHEMA

subscriptions.create-422

1 properties

JSON SCHEMA

subscriptions.patch-400

1 properties

JSON SCHEMA

subscriptions.patch-422

1 properties

JSON SCHEMA

subscriptions.revise-400

1 properties

JSON SCHEMA

subscriptions.revise-404

1 properties

JSON SCHEMA

subscriptions.revise-422

1 properties

JSON SCHEMA

subscriptions.suspend-400

1 properties

JSON SCHEMA

subscriptions.suspend-422

1 properties

JSON SCHEMA

subscriptions.transactions-400

1 properties

JSON SCHEMA

Subsequent Action

1 properties

JSON SCHEMA

Supplementary Data

1 properties

JSON SCHEMA

Capture Identifier

2 properties

JSON SCHEMA

Supporting Info

5 properties

JSON SCHEMA

Tax Information

2 properties

JSON SCHEMA

Tax

3 properties

JSON SCHEMA

Taxes Override

2 properties

JSON SCHEMA

Taxes

2 properties

JSON SCHEMA

Template Configuration

4 properties

JSON SCHEMA

Template Detail

0 properties

JSON SCHEMA

Template Display Preference

1 properties

JSON SCHEMA

Template Information

8 properties

JSON SCHEMA

Template Item Field

0 properties

JSON SCHEMA

Template Item Setting

2 properties

JSON SCHEMA

Template Metadata

4 properties

JSON SCHEMA

Template

8 properties

JSON SCHEMA

Template Settings

2 properties

JSON SCHEMA

Template Subtotal Field

0 properties

JSON SCHEMA

Template Subtotal Setting

2 properties

JSON SCHEMA

Templates

5 properties

JSON SCHEMA

templates.create-400

1 properties

JSON SCHEMA

templates.create-422

1 properties

JSON SCHEMA

templates.delete-403

1 properties

JSON SCHEMA

templates.get-403

1 properties

JSON SCHEMA

templates.update-400

1 properties

JSON SCHEMA

templates.update-422

1 properties

JSON SCHEMA

The 3D Secure Authentication Response

2 properties

JSON SCHEMA

token_attributes

0 properties

JSON SCHEMA

Token Request

3 properties

JSON SCHEMA

Token

2 properties

JSON SCHEMA

Tracker Collection

2 properties

JSON SCHEMA

Tracker Identifier Collection

2 properties

JSON SCHEMA

Tracking Identifier

3 properties

JSON SCHEMA

Tracker Item

6 properties

JSON SCHEMA

Order Tracker Response.

0 properties

JSON SCHEMA

tracker_status

0 properties

JSON SCHEMA

Tracking Information

4 properties

JSON SCHEMA

Tracking Number Type

0 properties

JSON SCHEMA

Tracking Status

0 properties

JSON SCHEMA

Transaction Details

7 properties

JSON SCHEMA

Transaction status

0 properties

JSON SCHEMA

Transaction Information

13 properties

JSON SCHEMA

Transaction Details

0 properties

JSON SCHEMA

List Transactions

4 properties

JSON SCHEMA

Trustly payment object

3 properties

JSON SCHEMA

Trustly payment object

4 properties

JSON SCHEMA

unit_of_measure

0 properties

JSON SCHEMA

universal_product_code

0 properties

JSON SCHEMA

Update Pricing Scheme

2 properties

JSON SCHEMA

Update Pricing Scheme Request

1 properties

JSON SCHEMA

url

0 properties

JSON SCHEMA

Base Vault Instruction Parameters

1 properties

JSON SCHEMA

vault_id

0 properties

JSON SCHEMA

Base vault Instruction parameters

1 properties

JSON SCHEMA

Vault Instruction

0 properties

JSON SCHEMA

vault_owner_id

0 properties

JSON SCHEMA

Saved Payment Source Response

4 properties

JSON SCHEMA

Venmo Request

0 properties

JSON SCHEMA

Venmo Response

0 properties

JSON SCHEMA

Venmo Wallet Attributes Response

1 properties

JSON SCHEMA

Venmo Wallet Attributes

2 properties

JSON SCHEMA

Venmo Wallet Experience Context

2 properties

JSON SCHEMA

Venmo payment request object

4 properties

JSON SCHEMA

Venmo Wallet Response Object

7 properties

JSON SCHEMA

Verify Webhook Signature Response

1 properties

JSON SCHEMA

Verify Webhook Signature

7 properties

JSON SCHEMA

Web Profile List

0 properties

JSON SCHEMA

Web Profile

6 properties

JSON SCHEMA

Webhook

4 properties

JSON SCHEMA

Webhook List

1 properties

JSON SCHEMA

Webhook Lookup List

1 properties

JSON SCHEMA

Webhook Lookup

3 properties

JSON SCHEMA

Scroll for all 576

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Paypal Structure

0 properties

JSON STRUCTURE

Examples 31

Example request and response payloads for these APIs.

Scroll for all 31

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Paypal Authentication

oauth2 · 1 scheme

SECURITY

Paypal Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Paypal Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Paypal Trust Center

PCI DSS, PCI P2PE, ISO/IEC 27001, SOC 1, SOC 2 Type II

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Paypal Scopes

39 scopes · clientCredentials

39 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Paypal Agentic Access

111 operations · 75 acting

111 operations · 75 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 3

Pagination, idempotency, versioning, errors, and events

Build 3

SDKs, sample code, and the tooling you integrate with

Access & Security 6

Authentication, authorization, and security posture

Operate 2

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: paypal
name: PayPal
description: PayPal is a global online payment system that lets individuals and businesses send and receive money electronically.
  PayPal exposes a broad surface of REST APIs covering payments, orders, subscriptions, invoicing, payouts, disputes, payment
  tokens, shipping tracking, transaction reporting, partner referrals, payment experience, and webhook notifications.
kind: contract
accessModel:
  pricing: paid
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Paid · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/paypal.png
tags:
- Billing
- Commerce
- Disputes
- Invoices
- Orders
- Payments
- Payouts
- Subscriptions
- Tokens
- Webhooks
created: '2024-04-14'
modified: '2026-05-30'
url: https://raw.githubusercontent.com/api-evangelist/paypal/refs/heads/main/apis.yml
specificationVersion: '0.20'
apis:
- aid: paypal:paypal-activate-api
  name: PayPal Activate API
  description: The Activate API from PayPal — 2 operation(s) for activate.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Activate
  properties:
  - type: OpenAPI
    url: openapi/paypal-activate-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-authorizations-api
  name: PayPal Authorizations API
  description: Use the `/authorizations` resource to show details for, capture payment for, reauthorize, and void authorized
    payments.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Authorizations
  properties:
  - type: OpenAPI
    url: openapi/paypal-authorizations-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-balances-api
  name: PayPal Balances API
  description: Use the `/balances` resource to list balances.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Balances
  properties:
  - type: OpenAPI
    url: openapi/paypal-balances-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-billing-api
  name: PayPal Billing API
  description: The Billing API from PayPal — 13 operation(s) for billing.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Billing
  properties:
  - type: OpenAPI
    url: openapi/paypal-billing-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-cancel-api
  name: PayPal Cancel API
  description: The Cancel API from PayPal — 1 operation(s) for cancel.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Cancel
  properties:
  - type: OpenAPI
    url: openapi/paypal-cancel-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-capture-api
  name: PayPal Capture API
  description: The Capture API from PayPal — 1 operation(s) for capture.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Capture
  properties:
  - type: OpenAPI
    url: openapi/paypal-capture-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-captures-api
  name: PayPal Captures API
  description: Use the `/captures` resource to show details for and refund a captured payment.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Captures
  properties:
  - type: OpenAPI
    url: openapi/paypal-captures-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-deactivate-api
  name: PayPal Deactivate API
  description: The Deactivate API from PayPal — 1 operation(s) for deactivate.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Deactivate
  properties:
  - type: OpenAPI
    url: openapi/paypal-deactivate-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-disputes-actions-api
  name: PayPal Disputes-Actions API
  description: Use the `/disputes` resource with a dispute ID and an action to:<ul><li>Accept a claim.</li><li>Accept an offer
    to resolve a dispute.</li><li>Acknowledge the return of an item related to a dispute.</li><li>Settle a dispute.</li><li>Appeal
    a dispute.</li><li>Cancel a dispute.</li><li>Change the reason for a dispute.</li><li>Deny an offer to resolve dispute.</li><li>Escalate
    a dispute to a claim.</li><li>Make an offer to resolve a dispute.</li><li>Make an offer to resolve a dispute.</li><li>Provide
    evidence for a dispute.</li><li>Provide supporting information for dispute.</li><li>In the sandbox, update the dispute
    status.</li><li>Send a message about a dispute to the other party in the dispute.</li><ul>
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Disputes-Actions
  properties:
  - type: OpenAPI
    url: openapi/paypal-disputes-actions-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-disputes-api
  name: PayPal Disputes API
  description: Use the `/disputes` resource to list disputes, create disputes, show dispute details, and partially a dispute.
    Normally, an agent at PayPal creates disputes but now you can run test cases in the sandbox that create disputes.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Disputes
  properties:
  - type: OpenAPI
    url: openapi/paypal-disputes-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-invoices-api
  name: PayPal Invoices API
  description: Use the `/invoices` resource to create, update, and send invoices and invoice reminders. To manage invoices,
    you can also list invoices, show details for invoices, delete draft invoices, and cancel sent invoices. You can also record
    payments for invoices to mark them as fully or partially paid, or record refunds for invoices to mark them as fully or
    partially refunded. You can create QR codes for invoices that can be scanned, viewed, and paid by a mobile phone.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Invoices
  properties:
  - type: OpenAPI
    url: openapi/paypal-invoices-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-orders-api
  name: PayPal Orders API
  description: Use the `/orders` resource to create, update, retrieve, authorize, capture and track orders.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/paypal-orders-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-partner-referrals-api
  name: PayPal Partner-Referrals API
  description: Enables you to create and get information about shared customer data.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Partner-Referrals
  properties:
  - type: OpenAPI
    url: openapi/paypal-partner-referrals-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-payment-tokens-api
  name: PayPal Payment-Tokens API
  description: Use the `/vault/payment-tokens` resource to create, retrieve, and delete a payment token that may optionally
    be associated with a customer.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Payment-Tokens
  properties:
  - type: OpenAPI
    url: openapi/paypal-payment-tokens-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-payouts-api
  name: PayPal Payouts API
  description: Use the `/payouts` resource to create a batch payout, update the status for a batch payout, show the status
    of a batch payout with the transaction status and other data for individual payout items, and request approval for a batch
    payout.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Payouts
  properties:
  - type: OpenAPI
    url: openapi/paypal-payouts-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-payouts-item-api
  name: PayPal Payouts-Item API
  description: Use the `/payouts-item` resource to show payout item details and cancel an unclaimed payout item.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Payouts-Item
  properties:
  - type: OpenAPI
    url: openapi/paypal-payouts-item-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-plans-api
  name: PayPal Plans API
  description: The Plans API from PayPal — 5 operation(s) for plans.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Plans
  properties:
  - type: OpenAPI
    url: openapi/paypal-plans-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-pricing-api
  name: PayPal Pricing API
  description: The Pricing API from PayPal — 1 operation(s) for pricing.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Pricing
  properties:
  - type: OpenAPI
    url: openapi/paypal-pricing-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/tracking/tracking-api/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payment-tokens/v3/
- aid: paypal:paypal-products-api
  name: PayPal Products API
  description: Use `/products` resource to create and manage products.
  humanURL: https://developer.paypal.com/docs/api/subscriptions/v1/
  tags:
  - Products
  properties:
  - type: OpenAPI
    url: openapi/paypal-products-api-openapi.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/api/subscriptions/v1/
  - type: GraphQL
    url: graphql/paypal-graphql.md
  - type: Documentation
    url: https://developer.paypal.com/docs/api/catalog-products/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/orders/v2/
  - type: Documentation
    url: https://developer.paypal.com/docs/disputes/integration-guide/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/partner-referrals/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/invoicing/v2/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/webhooks/
  - type: AsyncAPI
    url: openapi/paypal-webhooks-asyncapi-original.yml
  - type: Documentation
    url: https://developer.paypal.com/docs/payment-experience/
  - type: Documentation
    url: https://developer.paypal.com/api/rest/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/payments.payouts-batch/v1/
  - type: Documentation
    url: https://developer.paypal.com/docs/api/transaction-search/v1/
  - type: Documentation
    url: https://developer.paypal.co

# --- truncated at 32 KB (64 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/paypal/refs/heads/main/apis.yml