PayPal Search-Invoices API is one of 37 APIs that PayPal publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.
Tagged areas include Search-Invoices. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an AsyncAPI specification.
This API exposes
1 operation
across 1 path,
and defines 66 schemas.
It is described by OpenAPI 3.0.3, at version 1.6.
Requests are made against 2 base URLs: https://api-m.sandbox.paypal.com, https://api-m.paypal.com.
The identity and technical contract details declared by the specification.
file_reference
object
The file reference. Can be a file in PayPal MediaServ, PayPal DMS, or other custom store.
5 properties
error_404
object
The server has not found anything matching the request URI. This either means that the URI is incorrect or the resource is not available.
5 properties
payments
object
An array of payments registered against the invoice.
2 properties
language
string
The [language tag](https://tools.ietf.org/html/bcp47section-2) for the language in which to localize the error-related strings, such as messages, issues, and s…
error_409
object
The server has detected a conflict while processing this request.
5 properties
invoice_creation_flow
string
The frequency at which the invoice is sent: Multiple recipient. Sent to multiple recipients. Batch. Sent in a batch. Regular single. Sent one time to a single…
payment_term
object
The payment term of the invoice. Payment can be due upon receipt, a specified date, or in a set number of days.
1 property
phone_type
string
The phone type.
link_description
object
The request-related [HATEOAS link](/docs/api/reference/api-responses/hateoas-links) information.
3 properties
2 required
item
object
An array of invoice line item information. The maximum items for an invoice is 100.
9 properties
3 required
date_no_time
string
The stand-alone date, in [Internet date and time format](https://tools.ietf.org/html/rfc3339section-5.6). To represent special legal values, such as a date of…
payment_term_type
string
The payment term. Payment can be due upon receipt, a specified date, or in a set number of days.
aggregated_discount
object
The discount. Can be an item- or invoice-level discount, or both. Can be applied as a percent or amount. If you provide both amount and percent, amount takes p…
2 properties
error_403
object
The client is not authorized to access this resource, although it may have valid credentials.
5 properties
invoice_status
string
The status of the invoice.
invoices.search-invoices-400
object
1 property
error_422
object
The requested action cannot be performed and may require interaction with APIs or processes outside of the current request. This is distinct from a 500 respons…
5 properties
error_details
object
The error details. Required for client-side 4XX errors.
5 properties
1 required
name
object
The name of the party.
7 properties
invoice
object
The invoice details which includes all information of the invoice like items, billing information.
15 properties
1 required
metadata
object
The audit metadata. Captures all invoicing actions on create, send, update, and cancel.
phone_detail
object
The phone details. Includes the phone number and type.
1 required
refunds
object
The invoicing refund details. Includes the refund type, date, amount, and method.
2 properties
phone
object
The phone number, in its canonical international [E.164 numbering plan format](https://www.itu.int/rec/T-REC-E.164/en).
3 properties
2 required
error_link_description
object
The request-related [HATEOAS link](/api/rest/responses/hateoas-links) information.
3 properties
2 required
invoice_payment_term
object
The payment term of the invoice. Payment can be due upon receipt, a specified date, or in a set number of days.
amount_summary_detail
object
The invoice amount summary of item total, discount, tax total, and shipping.
3 properties
template_metadata
object
The audit metadata. Captures all template actions on create and update.
4 properties
recipient_info
object
The billing and shipping information. Includes name, email, address, phone, and language.
2 properties
configuration
object
The invoice configuration details. Includes partial payment, tip, and tax calculated after discount.
invoice_detail
object
The details of the invoice. Includes invoice number, date, payment terms, and audit metadata.
partial_payment
object
The partial payment details. Includes the minimum amount that the invoicer expects from the payer.
2 properties
detail
object
The details of the invoice like notes, terms and conditions, memo, attachments.
6 properties
1 required
error_default
The default error response.
date_time_range
object
The date and time range. Filters invoices by creation date, invoice date, due date, and payment date.
2 properties
2 required
discount
object
The discount as a percent or amount at invoice level. The invoice discount amount is subtracted from the item total.
2 properties
money
object
The currency and amount for a financial transaction, such as a balance or payment due.
2 properties
2 required
search_data
object
The invoice search parameters.
16 properties
template_configuration
object
The template configuration details. Includes tax information, tip, and partial payment.
4 properties
business_name
object
The business name of the party.
1 property
amount_with_breakdown
object
The breakdown of the amount. Includes total item amount, total tax amount, custom amount, and shipping and discounts, if any.
5 properties
address_portable
object
The portable international postal address. Maps to [AddressValidationMetadata](https://github.com/googlei18n/libaddressinput/wiki/AddressValidationMetadata) an…
10 properties
1 required
payment_detail
object
The payment details of the invoice. Includes payment type, method, date, discount, and transaction type.
7 properties
1 required
error_503
object
The server is temporarily unable to handle the request, for example, because of planned maintenance or downtime.
4 properties
error_400
object
Request is not well-formed, syntactically incorrect, or violates schema.
5 properties
payment_method
string
The payment mode or method through which the invoicer can accept the payments.
currency_code
string
The [three-character ISO-4217 currency code](/docs/integration/direct/rest/currency-codes/) that identifies the currency.
contact_name_address
object
The contact information of the user. Includes name and address.
shipping_cost
object
The shipping fee for all items. Includes tax on shipping.
2 properties
country_code
string
The [two-character ISO 3166-1 code](/docs/integration/direct/rest/country-codes/) that identifies the country or region. Note: The country code for Great Brita…
tax
object
The tax information. Includes the tax name and tax rate of invoice items. The tax amount is added to the item total.
3 properties
2 required
payment_type
string
The payment type. Can be PayPal or an external payment. Includes cash or a check.
error_401
object
Authentication failed due to missing Authorization header, or invalid authentication credentials.
5 properties
billing_info
object
The billing information of the invoice recipient. Includes name, address, email, phone, and language.
date_range
object
The date range. Filters invoices by creation date, invoice date, due date, and payment date.
2 properties
2 required
invoicer_info
object
The invoicer business information that appears on the invoice.
error_415
object
The server does not support the request payload's media type.
5 properties
amount_range
object
The amount range.
2 properties
2 required
unit_of_measure
string
The unit of measure for the invoiced item.
percentage
string
The percentage, as a fixed-point, signed decimal number. For example, define a 19.99% interest rate as 19.99.
error_500
object
This is either a system or application error, and generally indicates that although the client appeared to provide a correct request, something unexpected has…
4 properties
email_address
string
The internationalized email address. Note: Up to 64 characters are allowed before and 255 characters are allowed after the @ sign. However, the generally accep…
date_time
string
The date and time, in [Internet date and time format](https://tools.ietf.org/html/rfc3339section-5.6). Seconds are required while fractional seconds are option…
refund_detail
object
The refund details of the invoice. Includes the refund type, date, amount, and method.
5 properties
1 required
invoices
object
An array of merchant invoices. Includes the total invoices count and [HATEOAS links](/docs/api/reference/api-responses/hateoas-links) for navigation.
4 properties
custom_amount
object
The custom amount to apply to an invoice. If you include a label, you must include a custom amount.
2 properties
1 required
The full machine-readable OpenAPI contract behind this narrative.
Other APIs PayPal publishes across the network.
