samples/state_criminal_search.md
# State Criminal Search
## The State Criminal Search Object
### Example Response
```ruby
#<Checkr::StateCriminalSearch:0x3fd909bcd974 id=539fdcf335644a0ef4000001> JSON: {
"status": "pending",
"completed_at": "2019-05-14T19:43:32Z",
"turnaround_time": 455685,
"state": "CA",
"records": [],
"id": "539fdcf335644a0ef4000001",
"object": "test_state_criminal_search",
"uri": "/v1/state_criminal_searches/539fdcf335644a0ef4000001",
"created_at": "2014-06-17T06:15:47Z",
"estimated_completion_time": "2019-05-09T21:40:45Z",
"estimated_completion_date": "2019-05-10",
"filtered_by_positive_adjudication_records": []
}
```
## Retrieve an existing State Criminal Search
### Definition
```ruby
Checkr::StateCriminalSearch.retrieve({STATE_CRIMINAL_SEARCH_ID})
```
### Example Request
```ruby
require 'checkr' # Note the gem is named checkr-official
Checkr.api_key = "83ebeabdec09f6670863766f792ead24d61fe3f9"
ccs = Checkr::StateCriminalSearch.retrieve("539fdcf335644a0ef4000001")
```
### Example Response
```ruby
#<Checkr::StateCriminalSearch:0x3fd909bcd974 id=539fdcf335644a0ef4000001> JSON: {
"status": "pending",
"completed_at": "2019-05-14T19:43:32Z",
"turnaround_time": 455685,
"state": "CA",
"records": [],
"id": "539fdcf335644a0ef4000001",
"object": "test_state_criminal_search",
"uri": "/v1/state_criminal_searches/539fdcf335644a0ef4000001",
"created_at": "2014-06-17T06:15:47Z",
"estimated_completion_time": "2019-05-09T21:40:45Z",
"estimated_completion_date": "2019-05-10",
"filtered_by_positive_adjudication_records": []
}
```