Testimonial History Feed for CI

// +++++ The EWP Retentions API  +++++
/* 
+++++++++++++++++++++++++++++++++++++++++++++++++++++
This API provides information about cases where an expert was retained. 
The expert may or may not have been challenged in these cases. This API does not identify challenges. 
+++++++++++++++++++++++++++++++++++++++++++++++++++++
*/

GET /api/rest/v1/expert/123456/retentions
Allow: GET
Content-Type: application/json
Vary: Accept

{   
    "id":"12345" // The unique identifier for the expert 
    , "salutation":"Dr." //Professional Salutations only
    , "first_name":"John" //First Name
    , "middle_name":"William" //Middle Name or Initial
    , "last_name":"Doe" //Last Name
    , "suffix":"M.D." //Suffix (Could be professional or personal)
    , "also_known_as": "Johnathan W. Doe" //Also Known As
    , "nickname": "Joe"
    , "discipline:" : [
        "Internal Medicine"
        , "Family Medicine"
        , "Pediatrics"
    ]
    , "city":"New York"
    , "state":"NY"
    , "country":"USA"
    , "retention_count":23
    , "challenge_count": {"direct":3, "indirect":2}
    , "next": "https://www.expertwitnessprofiler.info/api/rest/v1/expert/123456/retentions?page=2",
    "previous": null,
    "retentions": [
        {
            "resource_uri": "https://www.expertwitnessprofiler.info/api/rest/v1/expert/123456/retentions/123456789"
            , "id": "123456789"
            , "case_caption": "John Doe"
            , "docket_numbers": []
            , "courts": [ // Each link below will have the details of the Courts where the case was filed. 
                // Multiple courts will be listed when a case is transferred or appealed or gets clubbed with/into another case.
                "https://www.expertwitnessprofiler.info/api/rest/v3/courts/insb/",
                "https://www.expertwitnessprofiler.info/api/rest/v3/courts/nysd/",
            ]
            , "area_of_law": "Personal Injury" // Will be mapped to the SALI area of law fields. All recent data is already mapped that way.
            , "retained_by":"Plaintiff"
            , "plaintiff_attorneys":["Eddins, Ron C."]
            , "defendant_attorneys":["Zolynski, Wade M.", "Hernandez, Shilo"]
            , "judges":["McGrath","Wheat","Cotter","Baker","Morris","Nelson","Rice"]
            , "created_on":"2019-01-01T00:00:00Z"
            , "updated_on":"2022-01-01T00:00:00Z"
            , "documents":[ //For each document, you will need to make a separate API call to get the metadata for the document and the actual document, if available.
                "https://www.expertwitnessprofiler.info/api/rest/v3/documents/6554564"
                , "https://www.expertwitnessprofiler.info/api/rest/v3/documents/6554565"
                , "https://www.expertwitnessprofiler.info/api/rest/v3/documents/6554566"
            ]
        },
        {
            "resource_uri": "https://www.expertwitnessprofiler.info/api/rest/v1/expert/123456/retentions/123456789"
            , "id": "123456789"
            , "case_caption": "John Doe"
            , "docket_numbers": []
            , "courts": [
                "https://www.expertwitnessprofiler.info/api/rest/v3/courts/insb/",
                "https://www.expertwitnessprofiler.info/api/rest/v3/courts/nysd/",
            ]
            , "area_of_law": "Personal Injury"
            , "retained_by":"Plaintiff"
            , "plaintiff_attorneys":[]
            , "defendant_attorneys":[]
            , "judges":[]
            , "created_on":"2019-01-01T00:00:00Z"
            , "updated_on":"2022-01-01T00:00:00Z"
        }
    ]
}