---
title: "GET /dev/v2/properties"
method: GET
path: "/dev/v2/properties"
tags: ["Properties", "List Properties"]
---

# GET /dev/v2/properties

`GET /dev/v2/properties`

## Request

- Base URL: `https://gateway.tollbit.com`
- URL: `https://gateway.tollbit.com/dev/v2/properties`
- Auth: API key in header `TollbitKey`

## Query parameters

- `pageSize` integer
- `pageToken` string
- `readyToLicense` boolean
- `from` string, date-time
- `to` string, date-time

## Response `200`

The request has succeeded.

- PagedPropertyListResponse
  - `nextToken` string, required
  - `items` PropertyListItem[], required
    - `domain` string, required: The property's domain, e.g. "example.com".
    - `name` string, required: The publisher-facing property name.
    - `addedAt` string, date-time, required: When the property was added to TollBit.
    - `ratesEnabledAt` string, date-time: When rates were most recently enabled on any of the property's licenses. Absent if rates were never enabled.
    - `readyToLicense` boolean, required: True when the property can be transacted on now: a verified property with a rates-enabled standard license.
    - `licenses` PropertyLicense[], required: The license types available on this property.
      - `type` string, required: License type, e.g. ON_DEMAND_LICENSE, ON_DEMAND_FULL_USE_LICENSE, CUSTOM_LICENSE.
      - `ratesEnabled` boolean, required: True when at least one license of this type has rates enabled.
      - `rates` PropertyRate[], required: All directory rates for this license type, plus bot rates matching the calling org's registered user agents (those carry a userAgent), each ordered by path prefix. Always empty for CUSTOM_LICENSE (negotiated pricing is not public). Page and time rates are not included; use the rates endpoints for exact per-URL pricing.
        - `pathPrefix` string, required
        - `priceMicros` integer, required
        - `currency` string, required
        - `userAgent` string: Present on bot rates: the registered user agent of the calling org this rate applies to. Absent on directory rates.

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `401`: Access is unauthorized.
- `403`: Access is forbidden.
- `404`: The server cannot find the requested resource.
- `500`: Server error

## Changes

- **2026-11-03** `c029f43ffede`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tollbit/apis/tollbit-services/changes/dev/v2/properties/get.md)

---

[API](https://skmtc.dev/tollbit/apis/tollbit-services.md) - [All operations](https://skmtc.dev/tollbit/apis/tollbit-services/llms.txt) - [OpenAPI document](https://skmtc.dev/tollbit/apis/tollbit-services/revisions/c029f43ffede?raw)