{"uid":"cap_sKLcHeu_85IMJ6OC4dx0Q","slug":"gateway-spraay-app-6f9d1f94","name":"Spraay Gateway – List Invoices by Address","description":"List invoices by address.","url":"https://gateway.spraay.app/api/v1/invoice/list","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"address":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"invoices":{"type":"array"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VoY-sqDl4Csli9wHQ8Rnx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a list of invoices associated with a given blockchain or wallet address.","exampleAgentPrompt":"Show me all the invoices associated with the wallet address 0xABC123 on Spraay.","exampleUseCases":[{"title":"Audit wallet payment history","prompt":"Can you pull up every invoice linked to wallet 0x742d35Cc6634C0532925a3b844Bc9e7595f42e1 so I can reconcile my Spraay transactions?"},{"title":"Track outstanding invoices by address","prompt":"I need to see which invoices are still pending for the crypto address 0xDEF456 — help me identify what payments are due."},{"title":"Reconcile blockchain payments automatically","prompt":"Fetch all invoices associated with 0x9B5AdBeD2B4aD9b6b7e2a5C8cF6d3E1aB2c4F5e on Spraay and give me a summary of paid versus unpaid items."}],"resultDescription":"An array of invoice objects linked to the specified address, including invoice details such as amounts, statuses, and related metadata.","failureModes":["Missing required 'address' query parameter returns a 400 error","Invalid or malformed address string may return empty array or error","Address with no associated invoices returns an empty invoices array","Payment failure via x402 protocol returns 402 Payment Required","Network or gateway timeout returns 5xx error"],"whenToPreferThis":"Use this endpoint when you need to retrieve all invoices tied to a specific blockchain or wallet address on the Spraay gateway, particularly in payment automation, accounting, or reconciliation workflows where invoice history per address is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:34:17.725Z","isFirstParty":false}