{
  "openapi": "3.0.1",
  "info": {
    "title": "Washington DC Landlord List & Rental License Lookup (DLCP)",
    "description": "Export every active Washington, DC rental licence (37,745 on 2026-11-08): landlord name and entity type, rental address with ward and parcel key, and the landlord's mailing address. Filter by rental type, ward, company-owned, out-of-DC mailing or newly licensed.",
    "version": "0.0",
    "x-build-id": "zzv414jfKlmUMsDMS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapebench~dc-landlord-rental-license-list/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapebench-dc-landlord-rental-license-list",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/scrapebench~dc-landlord-rental-license-list/runs": {
      "post": {
        "operationId": "runs-sync-scrapebench-dc-landlord-rental-license-list",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/scrapebench~dc-landlord-rental-license-list/run-sync": {
      "post": {
        "operationId": "run-sync-scrapebench-dc-landlord-rental-license-list",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "activity": {
            "title": "Rental type",
            "enum": [
              "one_family",
              "two_family",
              "apartment",
              "short_term_rental",
              "vacation_rental",
              "rooming_house",
              "boarding_house"
            ],
            "type": "string",
            "description": "Which DLCP rental licence activity to return. Leave empty for all seven. An unrecognised value is ignored with a log line; if nothing you gave is recognised, the run returns a free row saying so instead of every licence."
          },
          "activities": {
            "title": "Rental types (batch)",
            "type": "array",
            "description": "Several rental types in ONE run, e.g. one_family and two_family. Combined with 'Rental type' if you fill both.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "status": {
            "title": "Licence status",
            "enum": [
              "active",
              "all",
              "expired",
              "closed",
              "cancelled",
              "inactive",
              "denied",
              "suspended",
              "revoked"
            ],
            "type": "string",
            "description": "Leave empty for Active licences (or for every status when you look up licence numbers). 'all' adds closed, cancelled, expired, inactive and denied licences; 'expired' covers every 'Expired' variant DLCP files (Expired, Expired - Enforcement, Expired - 1st / 2nd / Final Penalty)."
          },
          "ward": {
            "title": "DC ward",
            "type": "string",
            "description": "DC ward of the rental property, 1 to 8."
          },
          "wards": {
            "title": "DC wards (batch)",
            "type": "array",
            "description": "Several wards in ONE run, e.g. 7 and 8.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "entityOwnersOnly": {
            "title": "Company-owned only (LLCs, partnerships, corporations, trusts)",
            "type": "boolean",
            "description": "Keep only licences whose holder's filed entity type is a company, partnership, trust or other organisation; drops sole proprietors (individual landlords) and the few licences with no entity type.",
            "default": false
          },
          "outOfStateMailingOnly": {
            "title": "Mailing address outside DC only",
            "type": "boolean",
            "description": "Keep only licences whose mailing (billing) address is outside the District, e.g. Maryland, Virginia, New York. Licences with no mailing address on file are dropped.",
            "default": false
          },
          "licensedSince": {
            "title": "Newly licensed since",
            "type": "string",
            "description": "Keep only licences first issued on or after this date (YYYY-MM-DD), e.g. 2026-01-01 for this year's new rental licences. Used as a filter only; rows carry no dates."
          },
          "licenseNumber": {
            "title": "Licence number",
            "type": "string",
            "description": "A DC Basic Business Licence number to look up, e.g. 500522003018. Searches every status unless you set one."
          },
          "licenseNumbers": {
            "title": "Licence numbers (batch)",
            "type": "array",
            "description": "Several licence numbers in ONE run. The run log names any that matched nothing. Filters of different kinds combine (a licence must match all of them), so leave the other filters empty for a plain lookup.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "name": {
            "title": "Owner name contains",
            "type": "string",
            "description": "Text the licence holder's name, owner name or trade name contains (case-insensitive), e.g. 'Henson Ridge' or 'Smith'."
          },
          "names": {
            "title": "Owner names (batch)",
            "type": "array",
            "description": "Several name fragments in ONE run; a licence matching any of them is returned once. The run log says how many licences each one matched.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "address": {
            "title": "Rental address",
            "type": "string",
            "description": "Street address of the rental property, e.g. '2628 10th Street NE'. Matched on whole words, with Street/ST, Avenue/AVE, Northwest/NW and similar spellings treated alike, so '12 Monroe St' never matches '112 Monroe St'. Leave out the city and ZIP."
          },
          "addresses": {
            "title": "Rental addresses (batch)",
            "type": "array",
            "description": "Several addresses in ONE run; a licence matching any of them is returned once.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Cap on licences returned for the whole run (a spend control). DC had 37,745 active rental licences on 2026-11-08, so 100000 returns every active one. The run log states how many matched when the cap cuts it short.",
            "default": 500
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. DC's open-data server answers direct requests; enable a proxy only if runs come back with a 'blocked' notice.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}