List Agent Listings

Returns the site owner's own MLS inventory: listings of the owner's agent ID or office ID, active or sold, newest first.

GET/v1/agent-listings

Authentication

Public key?key=pk_…

Public key in the `key` query parameter. No OAuth, no secret.

Edge cache: public, max-age=0, s-maxage=300, stale-while-revalidate=900

Query Parameters

keystring

required

The site's public key (pk_…). It selects the account. Safe to ship to the browser.

sourceenum

optional

`agent` uses the profile's MLS agent ID. `office` uses its MLS office ID.

Default:agent

agentoffice

statusenum

optional

`active` returns active listings. `sold` returns closed ones.

Default:active

activesold

pagenumber

optional

Page number, starting at 1. Values above 500 are treated as 500.

Default:1

pageSizenumber

optional

Cards per page. Values above 100 are capped at 100.

Default:24

Responses

200Success

application/json

availableboolean

False when the profile has no MLS agent or office ID. `listings` is then empty.

listingsarray

Listing cards (any property type), newest first.

totalnumber

All matching listings.

totalPagesnumber

`ceil(total / pageSize)`, at least 1.

Errors

400`source` is not `agent` or `office`, or `status` is not `active` or `sold`.

401Missing or invalid public key.

403The account is not active. The body also has `code: "TENANT_INACTIVE"`.

404The key's account does not exist or has no MLS data feed.

500Internal Server Error.

Notes

Hide a "My listings", "Sold" or "Office listings" tab when `total` is 0.
Cards use the same fields as `GET /v1/search` rows.

Request

curl --request GET \
  --url "https://api.pandaidx.com/v1/agent-listings?key={{public_key}}&pageSize=6"

Response200 OK

{
  "source": "agent",
  "status": "active",
  "page": 1,
  "pageSize": 24,
  "available": true,
  "listings": [
    {
      "_id": "6710a1b2c3d4e5f600000101",
      "ListingId": "A11855701",
      "OriginatingSystemKey": "miamire",
      "ListPrice": 725000,
      "LivingArea": 1180,
      "BedroomsTotal": 2,
      "BathroomsTotalInteger": 2,
      "StreetNumber": "1200",
      "StreetName": "Brickell Bay Dr",
      "UnitNumber": "2504",
      "City": "Miami",
      "StateOrProvince": "FL",
      "PostalCode": "33131",
      "StandardStatus": "Active",
      "PropertyType": "Residential",
      "PropertySubType": "Condominium",
      "image": "https://example.com/photos/A11855701/1.jpg",
      "Location": {
        "coordinates": [
          -80.1892,
          25.7651
        ]
      },
      "ListOfficeName": "Example Realty Group"
    }
  ],
  "total": 6,
  "totalPages": 1
}