# Get
source: https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/purchaserequest/invoice_addenda_data/getaddenda/index.md

> Get the details of the invoice addenda records for a purchase request.
Note: Invoice addenda data is not supported for ICMP.

## Parameters {#parameters}

|       Names       |                                              Description                                              | Required for ICCP | Required for ICMP |  Type   |
|-------------------|-------------------------------------------------------------------------------------------------------|-------------------|-------------------|---------|
| purchaseRequestId | ID of an active purchase request. Cannot get invoice addenda records for a canceled purchase request. | Yes               | No                | Numeric |
| fromIndex         | First record to get, starting from zero.                                                              | No                | No                | Numeric |
| toIndex           | Last record to get.                                                                                   | No                | No                | Numeric |

### Sample request 1 {#sample-request-1}

Get all invoice addenda records.

```xml
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
	<SOAP-ENV:Header/>
	<SOAP-ENV:Body>
		<ns2:getAddendaRequest xmlns="http://mastercard.com/sd/pc/service" xmlns:ns2="http://mastercard.com/sd/pc2/service">
			<ns2:purchaseRequestId>900497</ns2:purchaseRequestId>
		</ns2:getAddendaRequest>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
```

### Sample request 2 {#sample-request-2}

To get invoice addenda records between a particular range, send:

* A purchase request ID.
* A fromIndex number.
* A toIndex number.

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ser="http://mastercard.com/sd/pc2/service">
	<soapenv:Header/>
	<soapenv:Body>
		<ser:getAddendaRequest>
			<ser:purchaseRequestId>900497</ser:purchaseRequestId>
			<ser:fromIndex>1</ser:fromIndex>
			<ser:toIndex>3</ser:toIndex>
		</ser:getAddendaRequest>
	</soapenv:Body>
</soapenv:Envelope>
```

### Sample request 3 {#sample-request-3}

To get from the first invoice addenda record to an nth invoice addenda records, send:

* A purchase request Id.
* A toIndex number.

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ser="http://mastercard.com/sd/pc2/service">
	<soapenv:Header/>
	<soapenv:Body>
		<ser:getAddendaRequest>
			<ser:purchaseRequestId>900497</ser:purchaseRequestId>
			<ser:toIndex>3</ser:toIndex>
		</ser:getAddendaRequest>
	</soapenv:Body>
</soapenv:Envelope>
```

### Sample request 4 {#sample-request-4}

To get from an nth invoice addenda records to the last invoice addenda records, send:

* A purchase request Id.
* A fromIndex number.

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ser="http://mastercard.com/sd/pc2/service">
	<soapenv:Header/>
	<soapenv:Body>
		<ser:getAddendaRequest>
			<ser:purchaseRequestId>900497</ser:purchaseRequestId>
			<ser:fromIndex>6</ser:fromIndex>
		</ser:getAddendaRequest>
	</soapenv:Body>
</soapenv:Envelope>
```

## Response {#response}

For each request, you receive:

* A purchase request ID.
* Invoice addenda record details and their IDs.
* A count that shows the total number of invoice addenda records that a purchase request has.
* The fromIndex number if you included in the request.
* The toIndex number if you included in the request.

### Sample response {#sample-response}

```xml
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
	<soapenv:Body>
		<ns2:getAddendaResponse xmlns="http://mastercard.com/sd/pc/service"
			xmlns:ns2="http://mastercard.com/sd/pc2/service">
			<ns2:purchaseControlAddendaResponse>
				<ns2:purchaseRequestId>900497</ns2:purchaseRequestId>
				<ns2:responseDescription>Request for Get Addenda successfully created.</ns2:responseDescription>
				<ns2:addendaDataResponse>
					<ns2:globalInvoiceResponse>
						<ns2:globalInvoiceAddendaResponse>
							<ns2:globalInvoiceAddendumResponse>
								<Id>0ADN040200c28374478bbe3f23b4225f32f47a4f02181604a9c30f3890895f89d2241558448917</Id>
								<InvoiceNumber>234</InvoiceNumber>
								<InvoiceCurrencyAmount CurrencySign="D"
									CurrencyExponent="2" CurrencyCode="888">123213</InvoiceCurrencyAmount>
								<InvoiceDate>2020-02-29</InvoiceDate>
								<PONumber>123</PONumber>
							</ns2:globalInvoiceAddendumResponse>
						</ns2:globalInvoiceAddendaResponse>
						<ns2:globalInvoiceAddendaResponse>
							<ns2:globalInvoiceAddendumResponse>
								<Id>0ADN0b3e8ed0aa0729134ef901e27ea2e90db7341acd904518fe9bcefbb5f596c55c1558448930</Id>
								<InvoiceNumber>234</InvoiceNumber>
								<InvoiceCurrencyAmount CurrencySign="D"
									CurrencyExponent="2" CurrencyCode="888">123213</InvoiceCurrencyAmount>
								<InvoiceDate>2020-02-29</InvoiceDate>
								<PONumber>123</PONumber>
							</ns2:globalInvoiceAddendumResponse>
						</ns2:globalInvoiceAddendaResponse>
						<ns2:globalInvoiceAddendaResponse>
							<ns2:globalInvoiceAddendumResponse>
								<Id>0ADN1dbf0c74f732fd4dd36a028e0e296e8cf10e9f2551547563f8fa5d2b113960eb1558446992</Id>
								<InvoiceNumber>234</InvoiceNumber>
								<InvoiceCurrencyAmount CurrencySign="D"
									CurrencyExponent="2" CurrencyCode="888">123213</InvoiceCurrencyAmount>
								<InvoiceDate>2020-02-29</InvoiceDate>
								<PONumber>123</PONumber>
							</ns2:globalInvoiceAddendumResponse>
						</ns2:globalInvoiceAddendaResponse>
					</ns2:globalInvoiceResponse>
				</ns2:addendaDataResponse>
			</ns2:purchaseControlAddendaResponse>
			<ns2:totalAddendaCount>13</ns2:totalAddendaCount>
			<ns2:fromIndex>1</ns2:fromIndex>
			<ns2:toIndex>3</ns2:toIndex>
			<ns2:errorMessage xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
		</ns2:getAddendaResponse>
	</soapenv:Body>
</soapenv:Envelope>
```