Business Platforms and marketplacesPlatforms Enterprise

Business Platforms and marketplaces Enterprise

Sections

Business Platforms and marketplaces Enterprise

Help

FAQs Account help Technical support API Status

APIs & SDKs

JavaScript SDK React SDK REST API Server SDKs Codes Webhook events iOS Android

On this page

Resources

GitHub repo

Postman repo

PayPal.com

llms.txt

Where to find us

Developer blog

Community

Help Center

Sign up for updates

Where to hear from us

X

YouTube

LinkedIn

Discord

Legal

Privacy Policy

Terms of Service

Developer Agreement

© 2026 PayPal. All rights reserved.

We currently use cookies to improve and customize your experience on our site. If you accept, we’ll also use marketing cookies to show you personalized ads. Manage your cookies and learn more.

detail

The details of the invoice like notes, terms and conditions, memo, attachments.

referencestringOptional

The reference data. Includes a Purchase Order (PO) number.

Match^[\S\s]*$Length1 <= length <= 120

currency_codestring<currency_code>Required

The [3-character ISO-4217 currency code](/api/rest/reference/currency-codes/) that identifies the currency.

Match^[\S\s]*$Length3 <= length <= 3

notestringOptional

A note to the invoice recipient. Also appears on the invoice notification email.

Match^[\S\s]*$Length1 <= length <= 4000

terms_and_conditionsstringOptional

The general terms of the invoice. Can include return or cancellation policy and other terms and conditions.

Match^[\S\s]*$Length1 <= length <= 4000

memostringOptional

A private bookkeeping memo for the user.

Match^[\S\s]*$Length1 <= length <= 500

attachmentsobject<file_reference>[]Optional

An array of PayPal IDs for the files that are attached to an invoice.

Items0 <= length <= 32767

file_reference properties

5 properties

idstringOptional

The ID of the referenced file.

Match^.*$Length1 <= length <= 255

reference_urlstringOptional

The reference URL for the file.

FormaturiLength1 <= length <= 2000

content_typestringOptional

The [Internet Assigned Numbers Authority (IANA) media type of the file](https://www.iana.org/assignments/media-types/media-types.xhtml).

Match^.*$Length0 <= length <= 255

create_timestring<date_time>Optional

The date and time, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). Seconds are required while fractional seconds are optional.

Note: The regular expression provides guidance but does not reject all invalid dates.

Match^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$Length20 <= length <= 64

sizestringOptional

The size of the file, in bytes.

Match^[0-9]+$Length0 <= length <= 100

Back to top

On this page

No Headings