{
  "openapi": "3.1.0",
  "info": {
    "title": "LeadLists API",
    "version": "1.0.0",
    "summary": "Build verified lead lists of US local businesses from a plain-English request.",
    "description": "Create a list from a sentence such as \"roofing contractors in Dallas, TX with under 20 reviews\". LeadLists scans map listings for matches, then a build finds the owner's name, email (checked with the mail server) and phone for each business. Each lead with an email uses one lead from the plan's monthly allowance.\n\nAuthenticate with `Authorization: Bearer <api key>`. Create a key at https://app.leadlists.app/settings/api. Docs: https://leadlists.app/docs/api",
    "contact": {
      "name": "LeadLists",
      "email": "hello@leadlists.app",
      "url": "https://leadlists.app/contact"
    },
    "termsOfService": "https://leadlists.app/terms"
  },
  "externalDocs": {
    "url": "https://leadlists.app/docs/api"
  },
  "servers": [
    {
      "url": "https://app.leadlists.app"
    }
  ],
  "security": [
    {
      "apiKey": []
    }
  ],
  "paths": {
    "/api/me": {
      "get": {
        "operationId": "getMe",
        "summary": "The signed-in user and how many leads are left this month",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Me"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/lists": {
      "get": {
        "operationId": "listLists",
        "summary": "The user's lists, newest first",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "lists": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/List"
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "createList",
        "summary": "Create a list from a sentence and start the scan",
        "description": "Scanning is free. The response returns at once; poll getList until scan.status is done.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "sentence"
                ],
                "properties": {
                  "sentence": {
                    "type": "string",
                    "examples": [
                      "roofing contractors in Dallas, TX with under 20 reviews"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created; the scan has started.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "list": {
                      "$ref": "#/components/schemas/List"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "bad_request, or unsupported_request when the request can't be served from local-business data.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    }
                  ],
                  "properties": {
                    "suggestion": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/lists/{id}": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "List id, lst_…"
        }
      ],
      "get": {
        "operationId": "getList",
        "summary": "A list with its latest scan and build",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListDetail"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "patch": {
        "operationId": "updateList",
        "summary": "Rename a list or change its spec",
        "description": "Changing only filters re-filters at once. Changing who, where or radius_km starts a new scan.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "spec": {
                    "$ref": "#/components/schemas/Spec"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListDetail"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "deleteList",
        "summary": "Delete a list",
        "responses": {
          "204": {
            "description": "Deleted"
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/lists/{id}/build": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "List id"
        }
      ],
      "post": {
        "operationId": "buildLeads",
        "summary": "Build leads from the list's matches",
        "description": "Builds from unchecked matches in scan order. Only businesses where an email is found are charged, one lead each. Call again with another max_leads to find more.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "max_leads"
                ],
                "properties": {
                  "max_leads": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 10000
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "run": {
                      "$ref": "#/components/schemas/Run"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "402": {
            "description": "quota_exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/Error"
                    }
                  ],
                  "properties": {
                    "leads_left": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "409": {
            "description": "conflict: a build is already running",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/lists/{id}/stop": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "List id"
        }
      ],
      "post": {
        "operationId": "stopList",
        "summary": "Stop a list that is scanning or building; delivered leads are kept",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "404": {
            "description": "not_found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/lists/{id}/continue": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "List id"
        }
      ],
      "post": {
        "operationId": "continueBuild",
        "summary": "Resume a stopped build with its remaining max_leads",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "run": {
                      "$ref": "#/components/schemas/Run"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/runs/{id}/stop": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "Run id, run_…"
        }
      ],
      "post": {
        "operationId": "stopRun",
        "summary": "Stop a build",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "run": {
                      "$ref": "#/components/schemas/Run"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/lists/{id}/rows": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "List id"
        },
        {
          "name": "after_rev",
          "in": "query",
          "schema": {
            "type": "integer",
            "default": 0
          },
          "description": "Return rows changed after this revision."
        }
      ],
      "get": {
        "operationId": "getRows",
        "summary": "Rows of a list (matches, leads and no-email businesses)",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "rows": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/Row"
                      }
                    },
                    "rev": {
                      "type": "integer"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/rows/{id}": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "Row id, row_…"
        }
      ],
      "get": {
        "operationId": "getRow",
        "summary": "One row with the evidence for its email and owner",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "row": {
                      "$ref": "#/components/schemas/Row"
                    },
                    "evidence": {
                      "type": [
                        "object",
                        "null"
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    },
    "/api/lists/{id}/export": {
      "parameters": [
        {
          "name": "id",
          "in": "path",
          "required": true,
          "schema": {
            "type": "string"
          },
          "description": "List id"
        },
        {
          "name": "format",
          "in": "query",
          "schema": {
            "type": "string",
            "enum": [
              "csv",
              "xlsx"
            ],
            "default": "csv"
          }
        },
        {
          "name": "preset",
          "in": "query",
          "schema": {
            "type": "string",
            "enum": [
              "default",
              "instantly",
              "smartlead",
              "hubspot"
            ],
            "default": "default"
          },
          "description": "Column layout for the destination tool."
        },
        {
          "name": "scope",
          "in": "query",
          "schema": {
            "type": "string",
            "enum": [
              "leads",
              "all"
            ],
            "default": "leads"
          },
          "description": "leads: delivered rows only. all: also businesses without an email."
        }
      ],
      "get": {
        "operationId": "exportList",
        "summary": "Download the list as CSV or Excel",
        "responses": {
          "200": {
            "description": "The file, with a Content-Disposition header.",
            "content": {
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              },
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "401": {
            "description": "Missing, invalid or revoked API key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "plan_required: API access needs a paid plan.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "http",
        "scheme": "bearer",
        "description": "An API key from https://app.leadlists.app/settings/api (starts with ll_), or an OAuth access token."
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "examples": [
              "not_found"
            ]
          },
          "message": {
            "type": "string"
          }
        }
      },
      "Me": {
        "type": "object",
        "properties": {
          "user": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "email": {
                "type": "string"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "plan": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "leads_granted": {
                "type": "integer"
              },
              "leads_used": {
                "type": "integer"
              },
              "leads_left": {
                "type": "integer"
              },
              "period_end": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time"
              }
            }
          }
        }
      },
      "Spec": {
        "type": "object",
        "properties": {
          "who": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Map categories, e.g. roofing contractor"
          },
          "where": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "e.g. Dallas, TX"
          },
          "radius_km": {
            "type": "number",
            "default": 15
          },
          "filters": {
            "type": "object",
            "properties": {
              "min_reviews": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "max_reviews": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "min_rating": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "max_rating": {
                "type": [
                  "number",
                  "null"
                ]
              },
              "website": {
                "type": "string",
                "enum": [
                  "any",
                  "has",
                  "none"
                ]
              },
              "exclude": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "want": {
            "type": "object",
            "properties": {
              "owner": {
                "type": "boolean"
              },
              "email": {
                "type": "boolean"
              },
              "phone": {
                "type": "boolean"
              }
            }
          }
        }
      },
      "Counts": {
        "type": "object",
        "properties": {
          "found": {
            "type": "integer"
          },
          "matched": {
            "type": "integer"
          },
          "checked": {
            "type": "integer"
          },
          "leads": {
            "type": "integer"
          },
          "no_email": {
            "type": "integer"
          },
          "in_progress": {
            "type": "integer"
          }
        }
      },
      "List": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "sentence": {
            "type": "string"
          },
          "spec": {
            "$ref": "#/components/schemas/Spec"
          },
          "status": {
            "type": "string",
            "enum": [
              "scanning",
              "ready",
              "building",
              "stopped",
              "done",
              "empty",
              "failed"
            ]
          },
          "counts": {
            "$ref": "#/components/schemas/Counts"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "suggestions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "label": {
                  "type": "string"
                },
                "patch": {
                  "$ref": "#/components/schemas/Spec"
                },
                "count": {
                  "type": [
                    "integer",
                    "null"
                  ]
                },
                "rescan": {
                  "type": "boolean"
                }
              }
            }
          }
        }
      },
      "Scan": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "running",
              "done",
              "failed"
            ]
          },
          "points_total": {
            "type": "integer"
          },
          "points_done": {
            "type": "integer"
          },
          "found": {
            "type": "integer"
          },
          "matched": {
            "type": "integer"
          },
          "with_website": {
            "type": "integer"
          },
          "estimate": {
            "type": [
              "object",
              "null"
            ],
            "properties": {
              "low": {
                "type": "integer"
              },
              "high": {
                "type": "integer"
              }
            },
            "description": "Likely leads with an email; null until the sample is done."
          }
        }
      },
      "Run": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "stopping",
              "stopped",
              "completed",
              "failed"
            ]
          },
          "stop_reason": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "user",
              "quota",
              "exhausted",
              "target",
              "provider",
              "error",
              null
            ]
          },
          "max_leads": {
            "type": "integer"
          },
          "delivered": {
            "type": "integer"
          },
          "checked": {
            "type": "integer"
          },
          "no_email": {
            "type": "integer"
          },
          "in_progress": {
            "type": "integer"
          },
          "started_at": {
            "type": "string",
            "format": "date-time"
          },
          "ended_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "eta_seconds": {
            "type": [
              "integer",
              "null"
            ]
          }
        }
      },
      "ListDetail": {
        "type": "object",
        "properties": {
          "list": {
            "$ref": "#/components/schemas/List"
          },
          "scan": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Scan"
              },
              {
                "type": "null"
              }
            ]
          },
          "run": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Run"
              },
              {
                "type": "null"
              }
            ]
          }
        }
      },
      "Row": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "rev": {
            "type": "integer"
          },
          "state": {
            "type": "string",
            "enum": [
              "match",
              "in_progress",
              "lead",
              "no_email",
              "removed"
            ]
          },
          "business": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "area": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "reviews": {
            "type": [
              "integer",
              "null"
            ]
          },
          "locked": {
            "type": "boolean",
            "description": "Contact fields are null until the row is delivered."
          },
          "phone": {
            "type": [
              "string",
              "null"
            ]
          },
          "website": {
            "type": [
              "string",
              "null"
            ]
          },
          "owner": {
            "type": [
              "string",
              "null"
            ]
          },
          "email": {
            "type": [
              "string",
              "null"
            ]
          },
          "email_kind": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "personal",
              "shared",
              null
            ]
          },
          "delivered_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          }
        }
      }
    }
  }
}
