Sanctions Search API: v2

<back to all web services

CountIncompleteClients

Clients
The following routes are available for this service:
GET/clients/incomplete/countGet the number of incomplete clients
import Foundation
import ServiceStack

// @DataContract
public class CountIncompleteClients : BaseRequest
{
    /**
    * How many days should have elapsed before counting a Client as incomplete (defaults to 7 days).Set to zero to count all incomplete clients
    */
    // @DataMember
    // @ApiMember(Description="How many days should have elapsed before counting a Client as incomplete (defaults to 7 days).Set to zero to count all incomplete clients", ParameterType="query")
    public var daysIncomplete:Int

    /**
    * Count clients that match the state specified (only PendingCompletion, or PendingVerification).
    */
    // @DataMember
    // @ApiMember(Description="Count clients that match the state specified (only PendingCompletion, or PendingVerification).", ParameterType="query")
    public var state:ClientState

    /**
    * Count clients that match the IsValidateMe flag specified (defaults to true).
    */
    // @DataMember
    // @ApiMember(Description="Count clients that match the IsValidateMe flag specified (defaults to true).", ParameterType="query")
    public var isValidateMe:Bool

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

    private enum CodingKeys : String, CodingKey {
        case daysIncomplete
        case state
        case isValidateMe
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        daysIncomplete = try container.decodeIfPresent(Int.self, forKey: .daysIncomplete)
        state = try container.decodeIfPresent(ClientState.self, forKey: .state)
        isValidateMe = try container.decodeIfPresent(Bool.self, forKey: .isValidateMe)
    }

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

// @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. Can be provided in the request body, or as a header parameter (X-Api-User)
    */
    // @DataMember
    // @ApiMember(Description="The API User ID provided by us when you signed up to use our API. Can be provided in the request body, or as a header parameter (X-Api-User)", IsRequired=true, ParameterType="header, body")
    public var apiUserId:String

    /**
    * The API User Key provided by us when you signed up to use our API. Can be provided in the request body, or as a header parameter (X-Api-Key)
    */
    // @DataMember
    // @ApiMember(Description="The API User Key provided by us when you signed up to use our API. Can be provided in the request body, or as a header parameter (X-Api-Key)", IsRequired=true, ParameterType="header, body")
    public var apiUserKey:String

    /**
    * The User ID of the user making the request (e.g. a sub user). This is optional but can be used to associate API requests with a specific user, thereby allowing user permissions to be enforced. Can be provided in the body, or as a header parameter (X-User-Id).
    */
    // @DataMember
    // @ApiMember(Description="The User ID of the user making the request (e.g. a sub user). This is optional but can be used to associate API requests with a specific user, thereby allowing user permissions to be enforced. Can be provided in the body, or as a header parameter (X-User-Id).", ParameterType="header, body")
    public var userId:String

    required public init(){}
}

// @DataContract(Name="ClientState", Namespace="http://schemas.servicestack.net/types")
public enum ClientState : String, Codable
{
    case Undefined
    case PendingCompletion
    case PendingOcr
    case PendingVerification
    case Verified
}

// @DataContract
public class CountIncompleteClientsResponse : Codable
{
    // @DataMember
    public var data:CountIncompleteClientsData

    required public init(){}
}

public class CountIncompleteClientsData : BaseResponse
{
    public var numberOfIncompleteClients:Int

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

    private enum CodingKeys : String, CodingKey {
        case numberOfIncompleteClients
    }

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

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

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)
    }
}


Swift CountIncompleteClients 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.

GET /clients/incomplete/count HTTP/1.1 
Host: api.sanctionssearch.com 
Accept: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"data":{"numberOfIncompleteClients":0,"responseStatus":{"errorCode":"String","message":"String","stackTrace":"String","errors":[{"errorCode":"String","fieldName":"String","message":"String","meta":{"String":"String"}}],"meta":{"String":"String"}}}}