SourceFinch Verified · Building Permits

Street-Use Permits

Recent records from Street-Use Permits on data.sf.gov: up to 1,000 rows with stable identifiers for change monitoring. Contact columns are excluded.

Monitor this sourceAPI, CLI, SDK and MCP

What changedNo changes in 7 days

At a glance

Jurisdiction
data.sf.gov
Publisher updates
Updated by the publisher; typically daily or weekly
Recommended schedule
Daily for your monitor; SourceFinch verifies the recipe daily
Records per run
1,000 in the latest run
Record key
id
Acquired from
Open data portal: https://data.sf.gov/resource/b6tj-gt35.json?$select=permit_number,cnn,unique_identifier,streetname,cross_street_1,cross_street_2,permit_type,agent,permit_purpose,approved_date,status&$limit=1000&$order=permit_number
Recipe
v1.0.0, approved November 17, 2026
Version notes
First Verified version generated 2026-11-17 from batch backlog.
Verified since
November 17, 2026
Last green run
November 17, 2026
Changes, last 7 days
0 · see what changed

What the data contains

Open data published on data.sf.gov as “Street-Use Permits”. Each daily run reads up to 1,000 rows through the portal's SODA API, naming only non-contact columns. A monitor reports new and changed rows inside the cohort. Leaving the cohort does not establish deletion. SourceFinch is independent of the publisher.

Fields and types

Every record has these fields. The key field id identifies a record across runs, so changes are reported field by field.

FieldTypeDescription
idkeystringPublisher field `permit_number`. The record key.
cnnstring, nullablePublisher field `cnn`.
unique_identifierstring, nullablePublisher field `unique_identifier`.
streetnamestring, nullablePublisher field `streetname`.
cross_street_1string, nullablePublisher field `cross_street_1`.
cross_street_2string, nullablePublisher field `cross_street_2`.
permit_typestring, nullablePublisher field `permit_type`.
agentstring, nullablePublisher field `agent`.
permit_purposestring, nullablePublisher field `permit_purpose`.
approved_datedatetime, nullablePublisher field `approved_date`.
statusstring, nullablePublisher field `status`.

Sample output

The first 5 of 1,000 records from SourceFinch's own run on November 17, 2026, exactly as delivered.

FieldRecord 1Record 2Record 3Record 4Record 5
id00ADS-01200ADS-01300ADS-01300ADS-01300ADS-015
cnn130960006383000134120001062700011221000
unique_identifier00ADS-012_1309600000ADS-013_638300000ADS-013_1341200000ADS-013_1062700000ADS-015_11221000
streetnameVALLEJO STGRANT AVEWASHINGTON STPOST STSACRAMENTO ST
cross_street_1EMERY LNMAIDEN LNWALTER U LUM PLGRANT AVEDAVIS ST
cross_street_2TURK MURPHY LNPOST STWENTWORTH PLSTOCKTON STFRONT ST
permit_typeAddlStSpacAddlStSpacAddlStSpacAddlStSpacAddlStSpac
agentM H CONSTRUCTION MANAGEMENT CO. (Huey Construction Management Co.)Vahdani Group Co., Inc.Vahdani Group Co., Inc.Vahdani Group Co., Inc.Plant Construction Company
permit_purpose—————
approved_date—————
statusVOIDWITHDRAWWITHDRAWWITHDRAWCLOSED
Sample as JSON
[
  {
    "id": "00ADS-012",
    "cnn": "13096000",
    "agent": "M H CONSTRUCTION MANAGEMENT CO. (Huey Construction Management Co.)",
    "status": "VOID",
    "streetname": "VALLEJO ST",
    "permit_type": "AddlStSpac",
    "approved_date": null,
    "cross_street_1": "EMERY LN",
    "cross_street_2": "TURK MURPHY LN",
    "permit_purpose": null,
    "unique_identifier": "00ADS-012_13096000"
  },
  {
    "id": "00ADS-013",
    "cnn": "6383000",
    "agent": "Vahdani Group Co., Inc.",
    "status": "WITHDRAW",
    "streetname": "GRANT AVE",
    "permit_type": "AddlStSpac",
    "approved_date": null,
    "cross_street_1": "MAIDEN LN",
    "cross_street_2": "POST ST",
    "permit_purpose": null,
    "unique_identifier": "00ADS-013_6383000"
  },
  {
    "id": "00ADS-013",
    "cnn": "13412000",
    "agent": "Vahdani Group Co., Inc.",
    "status": "WITHDRAW",
    "streetname": "WASHINGTON ST",
    "permit_type": "AddlStSpac",
    "approved_date": null,
    "cross_street_1": "WALTER U LUM PL",
    "cross_street_2": "WENTWORTH PL",
    "permit_purpose": null,
    "unique_identifier": "00ADS-013_13412000"
  },
  {
    "id": "00ADS-013",
    "cnn": "10627000",
    "agent": "Vahdani Group Co., Inc.",
    "status": "WITHDRAW",
    "streetname": "POST ST",
    "permit_type": "AddlStSpac",
    "approved_date": null,
    "cross_street_1": "GRANT AVE",
    "cross_street_2": "STOCKTON ST",
    "permit_purpose": null,
    "unique_identifier": "00ADS-013_10627000"
  },
  {
    "id": "00ADS-015",
    "cnn": "11221000",
    "agent": "Plant Construction Company",
    "status": "CLOSED",
    "streetname": "SACRAMENTO ST",
    "permit_type": "AddlStSpac",
    "approved_date": null,
    "cross_street_1": "DAVIS ST",
    "cross_street_2": "FRONT ST",
    "permit_purpose": null,
    "unique_identifier": "00ADS-015_11221000"
  }
]

Evidence behind every value

  • Each run keeps the publisher's exact response, hashed with SHA-256. This sample came from a response with hash 8ec9e4bb553660c16093d9f6332f105e8bf06184010426fb22befa86080fa415.
  • Every value records where it came from in that response: a JSON Pointer into the retained capture.
  • Each run gets a signed manifest (Ed25519) timestamped by an RFC 3161 authority: this run's manifest hash is 5100a9e3ebcaf794d4a93663bb55c709f6579e6421454efe95cc1107103f0d47, timestamped November 17, 2026.
  • The compliance state at capture is recorded with the evidence: robots.txt hash and verdict, AI-preference signals, crawler identity and the usage rights below.
  • Download any run as an evidence bundle (WACZ) and check it offline, without trusting SourceFinch: sourcefinch verify-bundle run.wacz.

Terms posture and usage rights

Terms
Automated access permitted · publisher's terms
robots.txt
Allows this path · SHA-256 8cee1c5db0cf8d5b…
AI-preference signals
None observed at review
Public record
Yes. Municipal/state open data portal dataset b6tj-gt35 on data.sf.gov.
Reviewed
November 17, 2026; next review May 17, 2027
Licence basis
Publisher's terms of use
Commercial use
Allowed
Redistribution
Allowed
Attribution
Required (text below)

Published on the data.sf.gov open data portal for public use. Anonymous SODA API access needs no key. Portal robots.txt typically allows /resource/ with a crawl delay. Contact-name columns are not requested by this recipe.

Sf open data (data.sf.gov). SourceFinch is independent of the publisher.

Usage rights travel with every record SourceFinch delivers (API, exports, webhooks and evidence bundles). They are our documented understanding of the publisher's stated terms, not legal advice.

Reliability

Runs, last 30 days
1
Green
100%
Failed
0
Median run time
8.3 s
Latest run
success, November 17, 2026

Measured on completed runs of this recipe version across SourceFinch, anonymized, within a rolling 30-day window. First successful observation: November 17, 2026. A new recipe has only the history collected since that date; this is not a 30-day uptime guarantee.

Use it

Every surface creates the same monitor from this Verified recipe. Monitors keep record history, report field-level changes and deliver by webhook, export or email. You confirm you have the right to collect the source (rights: true).

Console

Open this recipe in the console: it preserves the reviewed URL, fields and record key. Review the latest captured sample, confirm source rights, and choose a schedule before creating your monitor.

Portable recipe

Copy into the console's Import or share a recipe panel to customize fields, types and schedules. This configuration contains no captured records or workspace IDs.

{
  "schema": "sourcefinch/source@1",
  "name": "Street-Use Permits",
  "url": "https://data.sf.gov/resource/b6tj-gt35.json?$select=permit_number,cnn,unique_identifier,streetname,cross_street_1,cross_street_2,permit_type,agent,permit_purpose,approved_date,status&$limit=1000&$order=permit_number",
  "recipe": {
    "mode": "http",
    "format": "json",
    "items": "[*]",
    "fields": {
      "id": "permit_number",
      "cnn": "cnn",
      "agent": "agent",
      "status": "status",
      "streetname": "streetname",
      "permit_type": "permit_type",
      "approved_date": "approved_date",
      "cross_street_1": "cross_street_1",
      "cross_street_2": "cross_street_2",
      "permit_purpose": "permit_purpose",
      "unique_identifier": "unique_identifier"
    },
    "required": [
      "id"
    ],
    "types": {
      "approved_date": "datetime"
    }
  },
  "schedule": "daily",
  "key_field": "id"
}

source.json

The request body used by the API, CLI and SDK examples.

{
  "name": "Street-Use Permits",
  "url": "https://data.sf.gov/resource/b6tj-gt35.json?$select=permit_number,cnn,unique_identifier,streetname,cross_street_1,cross_street_2,permit_type,agent,permit_purpose,approved_date,status&$limit=1000&$order=permit_number",
  "recipe": {
    "mode": "http",
    "format": "json",
    "items": "[*]",
    "fields": {
      "id": "permit_number",
      "cnn": "cnn",
      "agent": "agent",
      "status": "status",
      "streetname": "streetname",
      "permit_type": "permit_type",
      "approved_date": "approved_date",
      "cross_street_1": "cross_street_1",
      "cross_street_2": "cross_street_2",
      "permit_purpose": "permit_purpose",
      "unique_identifier": "unique_identifier"
    },
    "required": [
      "id"
    ],
    "types": {
      "approved_date": "datetime"
    }
  },
  "key_field": "id",
  "schedule": "daily",
  "rights": true,
  "catalog": {
    "slug": "sf-street-use-permits",
    "version_id": "5a96efd8-42bf-49ea-b5eb-4324fad3cbbd"
  }
}

REST API

Create an API key under Console → API keys. Reference: /docs/api.

# the Verified entry (fields, recipe, sample, terms) as JSON
curl https://sourcefinch.com/v1/catalog/sf-street-use-permits -H "Authorization: Bearer $SOURCEFINCH_API_KEY"

# create the monitor from source.json (below)
curl -X POST https://sourcefinch.com/v1/sources \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @source.json

# then run it now (later runs follow the schedule)
curl -X POST https://sourcefinch.com/v1/sources/$SOURCE_ID/runs \
  -H "Authorization: Bearer $SOURCEFINCH_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

CLI

The sourcefinch CLI is not on npm yet; see /docs/cli.

sourcefinch login
sourcefinch catalog get sf-street-use-permits --source-json > source.json
sourcefinch sources create --file source.json
sourcefinch runs create $SOURCE_ID --wait
sourcefinch records $SOURCE_ID

TypeScript SDK

The SDK is not on npm yet; see /docs/sdk.

import { SourceFinch } from "@sourcefinch/sdk";

const sf = new SourceFinch({ apiKey: process.env.SOURCEFINCH_API_KEY });
const entry = await sf.catalog.get("sf-street-use-permits");
const source = await sf.sources.create({
  catalog: { slug: entry.slug, version_id: entry.recipe.version_id },
  name: entry.name.slice(0, 100),
  url: entry.acquisition_path.endpoint,
  recipe: entry.recipe.definition,
  key_field: entry.recipe.key_field,
  schedule: entry.recipe.schedule,
  rights: true, // you confirm you have the right to collect this source
});
const run = await sf.runs.wait((await sf.runs.create(source.id)).id);
console.log(run.status);

MCP

Remote MCP server with OAuth; see /docs/mcp.

claude mcp add --transport http sourcefinch https://sourcefinch.com/mcp

# then ask your agent:
"Use SourceFinch to monitor Street-Use Permits: get_catalog_source sf-street-use-permits,
then create_source with its create_source_args (dry run first), then run_source."

Pricing

Each check is one run, whatever the number of records, and failed runs are free. On its default daily schedule this source uses about 30 runs a month, which fits the Free plan's 300 runs. It uses HTTP acquisition, so no browser runs are needed. See plans.

More from Sf open data and in building permits.

SourceFinch is independent and is not affiliated with or endorsed by Sf open data. This page describes street-use permits as SourceFinch acquires it.