REST API

API Documentation

Search sex offender registries, eviction records, and criminal court records across all 67 Florida counties via a simple REST API.

Get API Key View Endpoints

Getting Started

Quick Start

# Search sex offenders nationwide

curl "https://floridascreen-api.seefeldmaxwell1.workers.dev/v1/sex-offenders?first_name=John&last_name=Smith" \

-H "Authorization: Bearer fs_live_YOUR_KEY"

# Full combined search

curl "https://floridascreen-api.seefeldmaxwell1.workers.dev/v1/search?first_name=John&last_name=Smith" \

-H "Authorization: Bearer fs_live_YOUR_KEY"

Security

Authentication

All search endpoints require a valid API key in the Authorization header.

Authorization: Bearer fs_live_abc123def456

Public endpoints (/v1/health, /v1/counties) do not require authentication.

Configuration

Base URL

https://floridascreen-api.seefeldmaxwell1.workers.dev

Protocol

HTTPS only

Format

JSON

CORS

Enabled (all origins)

Reference

Endpoints

GET/v1/sex-offenders

LIVE

Search sex offender registries nationwide (FDLE + NSOPW)

Latency: 1-5 seconds (real-time)

Parameters

Name	Type	Required	Description
first_name	string	Required	Subject's first name
last_name	string	Required	Subject's last name
state	string	Optional	Filter by state (e.g., FL). Default: all 50 states

Response

{
  "success": true,
  "data": {
    "subject": { "first_name": "John", "last_name": "Smith" },
    "is_registered_offender": true,
    "total_records": 2,
    "records": [
      {
        "source": "FDLE",
        "name": "SMITH, JOHN MICHAEL",
        "designation": "Sexual Predator",
        "status": "Compliant",
        "county": "Miami-Dade",
        "state": "FL"
      }
    ]
  }
}

GET/v1/evictions

CACHED

Search eviction records across Florida county courts

Latency: Instant (cached) or 30-90s (first search)

Parameters

Name	Type	Required	Description
first_name	string	Required	Subject's first name
last_name	string	Required	Subject's last name
county	string	Optional	County slug (e.g., miami-dade). Default: all supported counties

Response

{
  "success": true,
  "data": {
    "subject": { "first_name": "John", "last_name": "Smith" },
    "total_records": 2,
    "records": [
      {
        "case_number": "2024-072782-CC-23",
        "county": "miami-dade",
        "case_type": "EVR",
        "filing_date": "04/12/2024",
        "status": "CLOSED",
        "plaintiff": "Sunshine Properties LLC",
        "defendant": "John Smith, Jr."
      }
    ]
  }
}

GET/v1/criminal

CACHED

Search criminal court records across Florida county courts

Latency: Instant (cached) or 30-90s (first search)

Parameters

Name	Type	Required	Description
first_name	string	Required	Subject's first name
last_name	string	Required	Subject's last name
county	string	Optional	County slug. Default: all supported counties

Response

{
  "success": true,
  "data": {
    "subject": { "first_name": "John", "last_name": "Smith" },
    "total_records": 1,
    "records": [
      {
        "case_number": "2021-MM-034521",
        "county": "palm-beach",
        "case_type": "Misdemeanor",
        "filing_date": "04/18/2021",
        "status": "Closed",
        "outcome": "Adjudication Withheld"
      }
    ]
  }
}

GET/v1/search

COMBINED

Combined search — sex offenders + evictions + criminal in one call

Latency: Sex offenders: real-time. Court records: cached or queued.

Parameters

Name	Type	Required	Description
first_name	string	Required	Subject's first name
last_name	string	Required	Subject's last name
county	string	Optional	County slug. Default: all supported counties

Response

{
  "success": true,
  "data": {
    "sex_offender": { "is_registered_offender": false, "total_records": 0 },
    "evictions": { "total_records": 2, "records": [ ... ] },
    "criminal": { "total_records": 1, "records": [ ... ] }
  },
  "meta": { "search_time_ms": 3200 }
}

GET/v1/counties

PUBLIC

List all 67 Florida counties with support status

Latency: Instant

Response

{
  "success": true,
  "data": {
    "total": 67,
    "supported": 57,
    "counties": [
      { "id": "miami-dade", "name": "Miami-Dade", "supported": true }
    ]
  }
}

GET/v1/health

PUBLIC

Service health check

Latency: Instant

Response

{
  "success": true,
  "data": { "status": "healthy" }
}

Errors

Error Codes

Code	Status	Description
UNAUTHORIZED	401	Missing or invalid API key
BAD_REQUEST	400	Missing required parameters
NOT_FOUND	404	Endpoint not found
RATE_LIMITED	429	Too many requests
PROCESSING	202	Search queued — poll again
INTERNAL_ERROR	500	Server error

Ready to integrate?

Get your API key and start searching Florida court records in minutes.

Get API Key

FloridaScreen provides access to publicly available court records and sex offender registries. This service is not a consumer reporting agency as defined by the FCRA. Users are responsible for compliance with all applicable laws.