# Marketplace ID Lookup

### Overview

In a scenario where you want to understand the AutoGrabID or data on listed vehicles, you can use the marketplace search system.

Prerequisites to access.

1. Be approved to access this special use case endpoint, contact your account manager.
2. Be aware of your listing ID and use that for the `marketplace_id` parameter. 
3. Be aware of your marketplace identifier, it is your public domain name, e.g `drive.com.au`

{% openapi src="/files/bupYK34BudsRm0rodLbg" path="/v2/vehicles/marketplace/" method="get" %}
[api.yaml](https://2006860467-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5qLYvzu45gdlTAGQCN9d%2Fuploads%2FQNJ2oRfASYWNsu7VjJHE%2Fapi.yaml?alt=media\&token=58a3820d-1bba-4403-8808-4c1bbeab3f41)
{% endopenapi %}

### Limitations

You are only able to search for a vehicle once it is present on our service. If you receive the error below this means we are not yet aware of the listing due to its recency. 

```json
{
  "error": true,
  "message": "Vehicle via marketplace drive.com.au/969515013 not found in database"
}
```

In this scenario, we recommend falling back to a test lookup using the title in its most descriptive format. E.g 2024 Nissan X-TRAIL Ti Wagon Ti 2.5L SUV 4WD. [Refer to the text searching guide here.](/uk-autograb-api-doc/vehicle-search/plain-text-search.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://devhub.autograb.com/uk-autograb-api-doc/vehicle-search/marketplace-id-lookup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.