ParseParse
Use CasesDocsAPI Reference
Log InGet Started Free
Menu
  • How it works
  • Use Cases
  • Docs
  • API Reference
  • Contact
REST API · Credit memo to JSON · 100 free pages/mo

Credit Note Extraction API

Pull credit notes and credit memos into structured JSON. The credit note number, the invoice it reverses, the reason, the tax split, and every line item - typed and ready to post against the open payable.

Get an API Key FreeRead the Docs

The Credit, and the Invoice It Belongs To

Send the credit note and a schema. The reference back to the original invoice comes out as its own field, which turns matching into a lookup instead of a search.

request.sh
curl -X POST \
  https://api-parse.conversiontools.io/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@credit-note.pdf" \
  -F 'schema={
    "credit_note_number": "string",
    "original_invoice_number": "string",
    "vendor": "string",
    "issue_date": "string",
    "reason": "string",
    "currency": "string",
    "subtotal": "number",
    "tax": "number",
    "total_credit": "number",
    "line_items": [{
      "description": "string",
      "quantity": "number",
      "unit_price": "number",
      "amount": "number"
    }]
  }'
response.json
{
  "status": "completed",
  "pages": 1,
  "data": {
    "credit_note_number": "CN-2026-00814",
    "original_invoice_number": "INV-2026-05531",
    "vendor": "Halberd Components BV",
    "issue_date": "2026-03-14",
    "reason": "Damaged goods returned",
    "currency": "EUR",
    "subtotal": 1240.00,
    "tax": 260.40,
    "total_credit": 1500.40,
    "line_items": [
      {
        "description": "Hinge assembly, 40mm",
        "quantity": 80,
        "unit_price": 12.50,
        "amount": 1000.00
      },
      {
        "description": "Restocking adjustment",
        "quantity": 1,
        "unit_price": 240.00,
        "amount": 240.00
      }
    ]
  }
}

Built for Accounts Payable & Receivable

A credit note is only useful once it is tied to the invoice it corrects. That one reference decides everything downstream.

The original invoice reference, as a field

The number the credit reverses is captured on its own, wherever the vendor chose to print it: in the header, on a memo line, or halfway through the reason text. That is what makes auto-matching possible at all.

Line-level credits, not just a total

Partial returns credit some lines and leave others alone. Each line comes back with description, quantity, unit price, and amount, so the credit lands on the right cost centre rather than in a suspense account.

Every vendor writes them differently

"Credit note", "credit memo", "Gutschrift", "nota de crédito" - the wording, the layout, and the tax treatment change per vendor and per country. One schema covers the lot, with no per-vendor template to maintain.

Frequently Asked Questions

How do I match a credit note back to the original invoice?

Declare original_invoice_number in your schema. It comes back as its own field, so your reconciliation job can look the invoice up directly instead of scanning document text for something that looks like a reference.

What if one credit note covers several invoices?

Declare the reference as an array in your schema and each invoice number comes back as a separate entry. That keeps a consolidated credit from collapsing into one unusable string that nothing can join on.

Are negative amounts returned as negative numbers?

That is up to your schema and your own convention. Amounts come back as typed numbers exactly as printed, so you apply the sign in your ledger logic rather than inferring it from a minus sign or a pair of brackets.

Does it read credit notes from different countries?

Yes. Field labels, date formats, and tax lines all differ by country. Because you describe the fields you want rather than their position on the page, the same schema handles a document from any of them.

How is financial data handled?

Uploaded documents are deleted automatically within 24 hours. Extracted data is encrypted in transit and at rest and is never used to train models.

More document extraction use cases

The same schema-driven API works across every document type. Define a schema once, extract from thousands of files.

Data Extraction API

Extract structured JSON from any document with custom schemas.

PDF Parsing API

Parse any PDF into structured JSON, scanned or digital.

Invoice extraction

Vendor, line items, totals, tax, and dates from invoices.

Receipt parsing

Store, items, totals, and payment method from receipts.

Purchase order extraction

PO number, vendor, buyer, and SKU-level line items.

Bank statement to JSON

Transactions, running balances, and dates for reconciliation.

Tax form extraction

Box-level data from W-2, 1099, and other tax forms.

Contract data extraction

Parties, dates, governing law, and key clauses.

Bill of lading extraction

Carrier, parties, ports, containers, and cargo.

Remittance advice extraction

Payments split across invoices for cash application.

Utility bill extraction

Meter readings, charges, and totals from any provider.

Financial statement extraction

Line items and periods from balance sheets and reports.

Quotation extraction

Vendor quotes in one shape so you can compare them.

Payslip extraction

Earnings, deductions, taxes, and year-to-date totals.

Resume parsing

Experience, education, and skills from any CV layout.

ID document extraction

Fields and MRZ from passports and ID cards.

Lease agreement extraction

Rent, term, deposits, and renewal deadlines.

Insurance claim extraction

Claim and policy numbers, dates, and claimed amounts.

Packing list extraction

Packages and SKU-level lines for receiving.

Delivery note extraction

Ordered versus delivered quantities and sign-off.

Close the Loop on Credits

Free tier covers your first 100 pages a month. No credit card to start.

Get Started FreeAPI Reference
Parse

AI-powered document data extraction

Conversion ToolsPowered by Conversion Tools

Use cases

  • Data Extraction API
  • PDF Parsing API
  • Invoice extraction
  • Receipt parsing
  • Purchase order extraction
  • Bank statement to JSON
  • Tax form extraction
  • Contract data extraction
  • Bill of lading extraction

Developers

  • How it works
  • Quickstart
  • Documentation
  • API Reference
  • n8n integration
  • Blog

Account

  • Log in
  • Contact
  • Security
  • Privacy Policy
  • Terms of Service
  • Refund Policy
© 2026 Conversion Tools