Get acquainted with our new Virginia State Legislative Information System! LIS Learning Center
Advanced Search
Back to List
Documentation Powered by ReDoc

Legislation (v1)

Download OpenAPI specification:Download

LIS API Help Desk: lis@dlas.virginia.gov URL: https://help.lis.virginia.gov/

Handles all high-level Legislation information, including search capabilities

Authentication

RefreshToken

Please enter the Refresh token

Security Scheme Type API Key
Header parameter name: Authorization

Bearer

Please enter JWT with Bearer into field

Security Scheme Type API Key
Header parameter name: Authorization

HeartBeat

HeartBeat controller for getting telemetry on service health.

Checks service health

Authorizations:
RefreshTokenBearer
header Parameters
WebAPIKey
string

Partner WebAPIKey

Responses

Response samples

Content type
application/json
{
  • "type": "string",
  • "title": "string",
  • "status": 0,
  • "detail": "string",
  • "instance": "string",
  • "property1": null,
  • "property2": null
}

PublicActions

Public actions Controller for reading data

Gets a list of Public Legislation

Authorizations:
RefreshTokenBearer
header Parameters
WebAPIKey
string

Partner WebAPIKey

Request Body schema:
application/json-patch+json
application/json-patch+json
application/json
text/json
application/*+json

AdvancedSearch

EventControlID
integer or null <int32>

Unique identifier for Event Control

StartDate
string or null <date-time>

Start Date associated with status dropdown

EndDate
string or null <date-time>

End Date associated with status dropdown

EventStartDate
string or null <date-time>

End Event Date, associated with Event Control dropdown

EventEndDate
string or null <date-time>

Start Event Date, associated with Event Control dropdown

IntroductionDate
string or null <date-time>
LegislationTitle
string or null
Description
string or null

Bill description

Chambercode
string or null

Chamber code (H/S)

LegislationStatusID
integer or null <int32>

Unique identifier for Legislation Status

LegislationCategoryID
integer or null <int32>

Unique identifier for Legislation Category

CommitteeID
integer or null <int32>

Unique identifier for Committee

SessionID
integer or null <int32>

Unique identifier for Session

SessionCode
integer or null <int32>

Session code (e.g. 20181)

LegislationEventTypeID
integer or null <int32>

Unique identifier for Legislation Event Type

SummaryLength
integer or null <int32>

Limitation on summary length

PatronTypes
Array of integers or null <int32>

List of Patron Types

MemberID
integer or null <int32>

Unique identifier for Member

SubjectIndexID
integer or null <int32>

Unique identifier for Subject Index

MostFrequent
boolean

Return most frequently accessed bills?

IsPending
boolean

Return pending bills?

KeywordExpression
string or null

Keyword search - supports operators and parentheses

KeywordLocation
string or null

Where to perform the Keyword search (Summary/Bill Text)

KeywordSummaryVersionID
integer or null <int32>

Unique identifier of Keyword Summary Version

KeywordLegislationVersionID
integer or null <int32>

Unique identifier of Keyword Legislation Version

KeywordUseGlobalSessionSearch
boolean

Should the keyword search search across all sessions?

SkipLegislationTextCalls
boolean or null

Skip searching legislation text?

CurrentStatus
boolean or null

Search by only the current bill status?

Array of objects or null (KeyWord)

List of KeyWord search objects

ExcludeFailed
boolean or null
ChapterNumber
string or null <= 10 characters

Chapter Number

Array of objects or null (LegislationNumberResponse)

List of Legislative Numbers

Array of objects or null (LegislationID)

List of Legislation IDs

Responses

Request samples

Content type
application/json-patch+json
application/json-patch+json
application/json
text/json
application/*+json
{
  • "EventControlID": 0,
  • "StartDate": "2019-08-24T14:15:22Z",
  • "EndDate": "2019-08-24T14:15:22Z",
  • "EventStartDate": "2019-08-24T14:15:22Z",
  • "EventEndDate": "2019-08-24T14:15:22Z",
  • "IntroductionDate": "2019-08-24T14:15:22Z",
  • "LegislationTitle": "string",
  • "Description": "string",
  • "Chambercode": "string",
  • "LegislationStatusID": 0,
  • "LegislationCategoryID": 0,
  • "CommitteeID": 0,
  • "SessionID": 0,
  • "SessionCode": 0,
  • "LegislationEventTypeID": 0,
  • "SummaryLength": 0,
  • "PatronTypes": [
    ],
  • "MemberID": 0,
  • "SubjectIndexID": 0,
  • "MostFrequent": true,
  • "IsPending": true,
  • "KeywordExpression": "string",
  • "KeywordLocation": "string",
  • "KeywordSummaryVersionID": 0,
  • "KeywordLegislationVersionID": 0,
  • "KeywordUseGlobalSessionSearch": true,
  • "SkipLegislationTextCalls": true,
  • "CurrentStatus": true,
  • "Keywords": [
    ],
  • "ExcludeFailed": true,
  • "ChapterNumber": "string",
  • "LegislationNumbers": [
    ],
  • "LegislationIDs": [
    ]
}

Response samples

Content type
application/json
{
  • "Success": true,
  • "FailureMessage": "string",
  • "CacheKeyName": "string",
  • "ListItems": [
    ],
  • "SearchCriteria": "string"
}

Gets a list of Public Legislation using unique identifier

Authorizations:
RefreshTokenBearer
path Parameters
legislationID
required
integer <int32>

Unique identifier for Legislation

header Parameters
WebAPIKey
string

Partner WebAPIKey

Responses

Response samples

Content type
application/json
{
  • "Success": true,
  • "FailureMessage": "string",
  • "CacheKeyName": "string",
  • "ListItems": [
    ],
  • "SearchCriteria": "string"
}

Gets a list of Legislation Statuses

Authorizations:
RefreshTokenBearer
header Parameters
WebAPIKey
string

Partner WebAPIKey

Responses

Response samples

Content type
application/json
{
  • "Success": true,
  • "FailureMessage": "string",
  • "CacheKeyName": "string",
  • "ListItems": [
    ]
}

Gets a list of Public Legislation by Session

Authorizations:
RefreshTokenBearer
query Parameters
sessionID
integer <int32>

Unique identifier for Session

sessionCode
integer <int32>

Session code (eg. 20181)

header Parameters
WebAPIKey
string

Partner WebAPIKey

Responses

Response samples

Content type
application/json
{
  • "Success": true,
  • "FailureMessage": "string",
  • "CacheKeyName": "string",
  • "ListItems": [
    ]
}

Gets a list of Public Legislation with Amendments by Session

Authorizations:
RefreshTokenBearer
query Parameters
sessionID
integer <int32>

Unique identifier for Session

sessionCode
integer <int32>

Session code (eg. 20181)

chamberCode
string

Chamber Code (e.g. H/S)

header Parameters
WebAPIKey
string

Partner WebAPIKey

Responses

Response samples

Content type
application/json
{
  • "Success": true,
  • "FailureMessage": "string",
  • "CacheKeyName": "string",
  • "ListItems": [
    ]
}

Gets a list of Legislation IDs

Authorizations:
RefreshTokenBearer
header Parameters
WebAPIKey
string

Partner WebAPIKey

Request Body schema:
application/json-patch+json
application/json-patch+json
application/json
text/json
application/*+json

AdvancedSearch

EventControlID
integer or null <int32>

Unique identifier for Event Control

StartDate
string or null <date-time>

Start Date associated with status dropdown

EndDate
string or null <date-time>

End Date associated with status dropdown

EventStartDate
string or null <date-time>

End Event Date, associated with Event Control dropdown

EventEndDate
string or null <date-time>

Start Event Date, associated with Event Control dropdown

IntroductionDate
string or null <date-time>
LegislationTitle
string or null
Description
string or null

Bill description

Chambercode
string or null

Chamber code (H/S)

LegislationStatusID
integer or null <int32>

Unique identifier for Legislation Status

LegislationCategoryID
integer or null <int32>

Unique identifier for Legislation Category

CommitteeID
integer or null <int32>

Unique identifier for Committee

SessionID
integer or null <int32>

Unique identifier for Session

SessionCode
integer or null <int32>

Session code (e.g. 20181)

LegislationEventTypeID
integer or null <int32>

Unique identifier for Legislation Event Type

SummaryLength
integer or null <int32>

Limitation on summary length

PatronTypes
Array of integers or null <int32>

List of Patron Types

MemberID
integer or null <int32>

Unique identifier for Member

SubjectIndexID
integer or null <int32>

Unique identifier for Subject Index

MostFrequent
boolean

Return most frequently accessed bills?

IsPending
boolean

Return pending bills?

KeywordExpression
string or null

Keyword search - supports operators and parentheses

KeywordLocation
string or null

Where to perform the Keyword search (Summary/Bill Text)

KeywordSummaryVersionID
integer or null <int32>

Unique identifier of Keyword Summary Version

KeywordLegislationVersionID
integer or null <int32>

Unique identifier of Keyword Legislation Version

KeywordUseGlobalSessionSearch
boolean

Should the keyword search search across all sessions?

SkipLegislationTextCalls
boolean or null

Skip searching legislation text?

CurrentStatus
boolean or null

Search by only the current bill status?

Array of objects or null (KeyWord)

List of KeyWord search objects

ExcludeFailed
boolean or null
ChapterNumber
string or null <= 10 characters

Chapter Number

Array of objects or null (LegislationNumberResponse)

List of Legislative Numbers

Array of objects or null (LegislationID)

List of Legislation IDs

Responses

Request samples

Content type
application/json-patch+json
application/json-patch+json
application/json
text/json
application/*+json
{
  • "EventControlID": 0,
  • "StartDate": "2019-08-24T14:15:22Z",
  • "EndDate": "2019-08-24T14:15:22Z",
  • "EventStartDate": "2019-08-24T14:15:22Z",
  • "EventEndDate": "2019-08-24T14:15:22Z",
  • "IntroductionDate": "2019-08-24T14:15:22Z",
  • "LegislationTitle": "string",
  • "Description": "string",
  • "Chambercode": "string",
  • "LegislationStatusID": 0,
  • "LegislationCategoryID": 0,
  • "CommitteeID": 0,
  • "SessionID": 0,
  • "SessionCode": 0,
  • "LegislationEventTypeID": 0,
  • "SummaryLength": 0,
  • "PatronTypes": [
    ],
  • "MemberID": 0,
  • "SubjectIndexID": 0,
  • "MostFrequent": true,
  • "IsPending": true,
  • "KeywordExpression": "string",
  • "KeywordLocation": "string",
  • "KeywordSummaryVersionID": 0,
  • "KeywordLegislationVersionID": 0,
  • "KeywordUseGlobalSessionSearch": true,
  • "SkipLegislationTextCalls": true,
  • "CurrentStatus": true,
  • "Keywords": [
    ],
  • "ExcludeFailed": true,
  • "ChapterNumber": "string",
  • "LegislationNumbers": [
    ],
  • "LegislationIDs": [
    ]
}

Response samples

Content type
application/json
{
  • "Success": true,
  • "FailureMessage": "string",
  • "CacheKeyName": "string",
  • "SortBy": "string",
  • "DeleteAllLegislationCache": true,
  • "LegislationIds": [
    ]
}

Gets a list of Conference Legislation

Authorizations:
RefreshTokenBearer
query Parameters
sessionID
integer <int32>

Unique identifier for Session

chamberCode
string

Chamber Code (e.g. H/S)

memberID
integer <int32>

Unique identifier for Member

header Parameters
WebAPIKey
string

Partner WebAPIKey

Responses

Response samples

Content type
application/json
{
  • "Success": true,
  • "FailureMessage": "string",
  • "CacheKeyName": "string",
  • "ListItems": [
    ]
}

Gets a list of Legislation based on set of Legislation IDs

Authorizations:
RefreshTokenBearer
header Parameters
WebAPIKey
string

Partner WebAPIKey

Request Body schema:
application/json-patch+json
application/json-patch+json
application/json
text/json
application/*+json

LegislationIdsListResponse

Success
boolean

Is this a successful response?

FailureMessage
string or null

Details if this response failed

CacheKeyName
string or null

CacheKey name

SortBy
string or null

Which column to sort legislation by

DeleteAllLegislationCache
boolean or null

Should delete from cache all legislation?

Array of objects or null (LegislationIdListResponse)

List of Legislation IDs

Responses

Request samples

Content type
application/json-patch+json
application/json-patch+json
application/json
text/json
application/*+json
{
  • "Success": true,
  • "FailureMessage": "string",
  • "CacheKeyName": "string",
  • "SortBy": "string",
  • "DeleteAllLegislationCache": true,
  • "LegislationIds": [
    ]
}

Response samples

Content type
application/json
{
  • "Success": true,
  • "FailureMessage": "string",
  • "CacheKeyName": "string",
  • "ListItems": [
    ],
  • "SearchCriteria": "string"
}

Clear all cache for this controller

Authorizations:
RefreshTokenBearer
header Parameters
WebAPIKey
string

Partner WebAPIKey

Responses

Response samples

Content type
application/json
{
  • "type": "string",
  • "title": "string",
  • "status": 0,
  • "detail": "string",
  • "instance": "string",
  • "property1": null,
  • "property2": null
}

Gets telemetry on service health

Authorizations:
RefreshTokenBearer
header Parameters
WebAPIKey
string

Partner WebAPIKey

Responses

Response samples

Content type
application/json
{
  • "User": "string",
  • "DateTime": "string",
  • "Environment": "string",
  • "ActionName": "string",
  • "Service": "string",
  • "Success": true,
  • "FailureMessage": "string"
}
LIS HomeWebsite FeedbackFor DevelopersPrivacy PolicyData Files
© Copyright Commonwealth of Virginia 2025. All rights reserved. Site developed by the Division of Legislative Automated Systems (DLAS)