Skip to main content
GET
Get a patent family by id

Authorizations

Authorization
string
header
required

Use a personal or organization Pav API key from Pav developer settings. Send it as Authorization: Bearer <api_key>.

Path Parameters

family_id
string
required

Pav patent family id.

Maximum string length: 64
Pattern: ^[A-Za-z0-9_-]+$
Example:

"62662313"

Response

Successful Response

family_id
string
required

Pav patent family identifier.

Example:

"62662313"

member_count
integer
required

Applications in the family.

granted_count
integer
required

Granted members.

pending_count
integer
required

Pending members.

has_live_member
boolean
required

True when any member is pending or in force.

owner_source
enum<string>
required

Which members owner_names was read from.

Available options:
live_members,
all_members,
none
owner_is_split
boolean
required

True when live members have different owners.

has_open_security_interest
boolean
required

True when any member carries an open security interest.

events_total
integer
required

Uncapped count of events.

representative_title
string | null

Representative title.

earliest_priority_date
string<date> | null

Earliest priority date.

earliest_filing_date
string<date> | null

Earliest member filing.

latest_grant_date
string<date> | null

Most recent grant.

latest_status_date
string<date> | null

Most recent status change.

owner_names
string[]

Owners of the live members; for a lapsed family, owners across all members.

companies
PatentCompany · object[]

Owners linked to Pav companies.

latest_maintenance_fee_date
string<date> | null

Most recent maintenance-fee payment on any member.

statutory_term_start
string<date> | null

Earliest nonprovisional filing the family claims (35 USC 154(a)(2)). Null when an ancestor's filing date is unknown.

statutory_term_end
string<date> | null

statutory_term_start plus 20 years. Term adjustments and extensions are not applied.

cpc_codes
string[]

Most-used CPC codes across members.

members
PatentFamilyDetailMember · object[]

Member applications.

ownership
PatentOwnershipEvent · object[]

Recorded conveyances, newest first.

events
PatentProsecutionEvent · object[]

Prosecution and maintenance events, newest first (capped).