GET Async Batch Job Results enterprise only

Note

This is a synchronous call that streams CSV result data with chunked transfer-encoding.

The batch job results service allows you to retrieve the geocoded results for a completed batch job. Results are returned as CSV data with detailed location information for each processed record.

Resource URL

https://www.mapquestapi.com/geocoding/v1/batch/jobs/{jobId}/results

Resource Information

Response Formats	CSV
Authentication	Yes (Requires Key)
Rate Limited	Yes

Request Parameters

Request Parameter	Description	Required
key	The API Key, which is needed to make requests to MapQuest services.	Yes

Note: The jobId is specified in the URL path, not as a query parameter.

Response Format

The response is returned as:

• Content-Type: text/plain
• Transfer-Encoding: chunked
• Format: CSV with pipe (|) delimited fields

CSV Field Descriptions

Field	Type	Description
recId	string	Record identifier (matches input recId or auto-generated)
seqNumber	number	Sequence number of the result
seqLength	number	Total length of the sequence
position	string	Latitude and longitude coordinates in format (lat,lng)
address	string	Formatted address string
title	string	Display title for the location

Example Request

curl -X GET "https://www.mapquestapi.com/geocoding/v1/batch/jobs/abc123-def456-ghi789/results?key=YOUR_API_KEY"

Example Response

The response is a CSV stream with the following format:

recId|seqNumber|seqLength|position|address|title
1|1|1|(39.74001,-104.99202)|Denver, CO, United States|Denver, CO, United States
2|1|1|(40.01574,-105.27924)|Boulder, CO, United States|Boulder, CO, United States
3|1|1|(39.19002,-106.81818)|Aspen, CO, United States|Aspen, CO, United States

Important Notes

• Blocking Call: This is a synchronous request that returns immediately with results
• Authentication: Same API key as other endpoints, passed as query parameter
• Job ID: The job ID is passed in the URL path, not as a query parameter
• Job Status: Results are only available when the job status is completed
• Streaming Response: Results are streamed with chunked transfer-encoding for large datasets
• CSV Format: Results are returned as pipe-delimited CSV data
• Content-Type: Response uses text/plain content type
• Error Handling: If the job failed or is still processing, this endpoint will return an error