0

List bill attachments

by
Published Oct 17, 2025

The *List bill attachments* endpoint returns a list of attachments available to download for a given `billId`. [Bills](https://docs.codat.io/sync-for-payables-api#/schemas/Bill) are invoices that represent the SMB's financial obligations to their supplier for a purchase of goods or services.

Script codat Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type Codat = {
3
	encodedKey: string
4
}
5
/**
6
 * List bill attachments
7
 * The *List bill attachments* endpoint returns a list of attachments available to download for a given `billId`.
8

9
[Bills](https://docs.codat.io/sync-for-payables-api#/schemas/Bill) are invoices that represent the SMB's financial obligations to their supplier for a purchase of goods or services.
10
 */
11
export async function main(auth: Codat, companyId: string, connectionId: string, billId: string) {
12
	const url = new URL(
13
		`https://api.codat.io/companies/${companyId}/connections/${connectionId}/data/bills/${billId}/attachments`
14
	)
15

16
	const response = await fetch(url, {
17
		method: 'GET',
18
		headers: {
19
			Authorization: `Basic ${auth.encodedKey}`
20
		},
21
		body: undefined
22
	})
23
	if (!response.ok) {
24
		const text = await response.text()
25
		throw new Error(`${response.status} ${text}`)
26
	}
27
	return await response.json()
28
}
29