URSY.DEVPART OF THE URSY NETWORKSign inBuild with URSY

Every contract sourcedEvery check datedGaps shown, never filledBuild with URSY

Endpoints

Search active adverts

Search active adverts

GET/listingsv1.1.1

Request

This operation declares public access.

CURL
curl 'https://ursy.autos/wp-json/ursy-autos/v1/listings' \
  -H 'Accept: application/json'
Scopes
None declared
Execution
At the owning service
Risk classification
not declared

Parameters

make query · string

See the accepted schema for constraints.

model query · string

See the accepted schema for constraints.

min_price query · string

See the accepted schema for constraints.

max_price query · string

See the accepted schema for constraints.

min_year query · string

See the accepted schema for constraints.

max_year query · string

See the accepted schema for constraints.

min_mileage query · string

See the accepted schema for constraints.

max_mileage query · string

See the accepted schema for constraints.

fuel query · string

See the accepted schema for constraints.

gearbox query · string

See the accepted schema for constraints.

body query · string

See the accepted schema for constraints.

colour query · string

See the accepted schema for constraints.

doors query · string

See the accepted schema for constraints.

seller_type query · string

See the accepted schema for constraints.

nation query · string

See the accepted schema for constraints.

postcode query · string

See the accepted schema for constraints.

radius query · string

See the accepted schema for constraints.

keywords query · string

See the accepted schema for constraints.

sort query · string

See the accepted schema for constraints.

page query · string

See the accepted schema for constraints.

per_page query · string

See the accepted schema for constraints.

dealer query · string

Stable merchant ID (ud_…), merchant slug, or legacy numeric owner ID.

This operation is documented here. Use the owning service with the appropriate credentials and permissions to execute it.

Response schemas and request body
CONTRACT JSON
{
    "requestBody": null,
    "responses": {
        "200": {
            "description": "Matching adverts and deterministic organic order",
            "content": {
                "application/json": {
                    "schema": {
                        "type": "object",
                        "required": [
                            "items",
                            "total",
                            "page"
                        ],
                        "properties": {
                            "items": {
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/Listing"
                                }
                            },
                            "total": {
                                "type": "integer"
                            },
                            "page": {
                                "type": "integer"
                            },
                            "inventory_revision": {
                                "type": "integer"
                            }
                        }
                    }
                }
            }
        },
        "429": {
            "description": "Fair-use limit; retry after the stated interval"
        }
    }
}