Sanctions Search API: v2

<back to all web services

GetValidIds

ValidID
The following routes are available for this service:
POST/validid/listGet all the ValidID Searches
import Foundation
import ServiceStack

// @DataContract
public class GetValidIds : BaseRequest
{
    // @DataMember
    public var request:GetValidIdsRequest

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case request
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        request = try container.decodeIfPresent(GetValidIdsRequest.self, forKey: .request)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if request != nil { try container.encode(request, forKey: .request) }
    }
}

// @DataContract
public class BaseRequest : IBaseRequest, Codable
{
    /**
    * The authentication credentials
    */
    // @DataMember
    // @ApiMember(Description="The authentication credentials", IsRequired=true, ParameterType="header, body")
    public var authentication:Authentication

    required public init(){}
}

// @DataContract
public class Authentication : Codable
{
    /**
    * The API User ID provided by us when you signed up to use our API
    */
    // @DataMember
    // @ApiMember(Description="The API User ID provided by us when you signed up to use our API", IsRequired=true, ParameterType="header, body")
    public var apiUserId:String

    /**
    * The API User Key provided by us when you signed up to use our API
    */
    // @DataMember
    // @ApiMember(Description="The API User Key provided by us when you signed up to use our API", IsRequired=true, ParameterType="header, body")
    public var apiUserKey:String

    required public init(){}
}

public class GetValidIdsRequest : Codable
{
    /**
    * If the searches are being accessed by a sub user, specify their username here to only return searches they have permissions to view
    */
    // @ApiMember(Description="If the searches are being accessed by a sub user, specify their username here to only return searches they have permissions to view")
    public var subUserName:String

    public var page:Int
    public var sortOrder:String
    public var nameSearch:String
    public var filterReference:String
    public var filterType:String
    public var filterDateFrom:Date?
    public var filterDateTo:Date?
    /**
    * If set, will only return searches created by the user
    */
    // @ApiMember(Description="If set, will only return searches created by the user")
    public var filterUserName:String

    required public init(){}
}

// @DataContract
public class GetValidIdsResponse : Codable
{
    // @DataMember
    public var data:GetValidIdsData

    required public init(){}
}

public class GetValidIdsData : BaseResponse
{
    public var totalSearchRecords:Int
    public var currentPageNum:Int
    public var maxPageNum:Int
    public var searchRecords:ArrayOfValidIdListItem

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case totalSearchRecords
        case currentPageNum
        case maxPageNum
        case searchRecords
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        totalSearchRecords = try container.decodeIfPresent(Int.self, forKey: .totalSearchRecords)
        currentPageNum = try container.decodeIfPresent(Int.self, forKey: .currentPageNum)
        maxPageNum = try container.decodeIfPresent(Int.self, forKey: .maxPageNum)
        searchRecords = try container.decodeIfPresent(ArrayOfValidIdListItem.self, forKey: .searchRecords)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if totalSearchRecords != nil { try container.encode(totalSearchRecords, forKey: .totalSearchRecords) }
        if currentPageNum != nil { try container.encode(currentPageNum, forKey: .currentPageNum) }
        if maxPageNum != nil { try container.encode(maxPageNum, forKey: .maxPageNum) }
        if searchRecords != nil { try container.encode(searchRecords, forKey: .searchRecords) }
    }
}

public class BaseResponse : IBaseDataResponse, IHasResponseStatus, Codable
{
    /**
    * The status of the response
    */
    // @ApiMember(Description="The status of the response")
    public var responseStatus:ResponseStatus

    required public init(){}
}

public class ArrayOfResponseError : List<ResponseError>
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

public class ArrayOfValidIdListItem : List<ValidIdListItem>
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

public class ValidIdListItem : Codable
{
    public var id:Int
    public var type:Int
    public var score:Int?
    public var status:String
    public var dateSearched:Date
    public var reference:String
    public var pepError:Bool
    public var replaced:Bool
    public var replacementSearchId:Int?
    public var hasCompletedRequest:Bool
    public var hasCompletedSearch:Bool
    public var searchCriteria:ValidIdSearchCriteria

    required public init(){}
}

public class ValidIdSearchCriteria : Codable
{
    public var fullName:String
    public var dateOfBirth:Date
    public var gender:String
    public var address:String

    required public init(){}
}


Swift GetValidIds DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /validid/list HTTP/1.1 
Host: api.sanctionssearch.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{"request":{"subUserName":"String","page":0,"sortOrder":"String","nameSearch":"String","filterReference":"String","filterType":"String","filterDateFrom":"\/Date(-62135596800000-0000)\/","filterDateTo":"\/Date(-62135596800000-0000)\/","filterUserName":"String"},"authentication":{"apiUserId":"String","apiUserKey":"String"}}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"data":{"totalSearchRecords":0,"currentPageNum":0,"maxPageNum":0,"searchRecords":[{"id":0,"type":0,"score":0,"status":"String","dateSearched":"\/Date(-62135596800000-0000)\/","reference":"String","pepError":false,"replaced":false,"replacementSearchId":0,"hasCompletedRequest":false,"hasCompletedSearch":false,"searchCriteria":{"fullName":"String","dateOfBirth":"\/Date(-62135596800000-0000)\/","gender":"String","address":"String"}}],"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}}