{"openapi":"3.0.0","info":{"description":"","title":"Rabo Identity Services - Fourthline IDV","version":"1.54.0","x-api-id":"f583166f-2f06-428a-bc69-1d3b833e8454","x-ibm-name":"rabo-identity-services-fourhtids"},"servers":[{"url":"https://api.rabobank.nl/openapi/","description":"Production server"},{"url":"https://api-sandbox.rabobank.nl/openapi/sandbox/","description":"Sandbox server"}],"paths":{"/ris/fourthline/keys":{"get":{"responses":{"200":{"content":{"application/json":{"examples":{"response":{"value":{"keys":[{"alg":"RS256","e":"AQAB","kid":"12345","kty":"RSA","n":"0vx7agoebGcQSuuPiLJXZptN9nndrQmbXEps2aiAFbWhM78LhWx 4cbbfAAtVT86zwu1RK7aPFFxuhDR1L6tSoc_BJECPebWKRXjBZCiFV4n3oknjhMs tn64tZ_2W-5JsGY4Hc5n9yBXArwl93lqt7_RN5w6Cf0h4QyQ5v-65YGjQR0_FDW2 QvzqY368QQMicAtaSqzs8KJZgnYb9c7d0zgdAZHzu6qMQvRL5hajrn1n91CbOpbI SD08qNLyrdkt-bFTWhAI4vMQFh6WeZu0fM4lFd2NcRwr3XPksINHaQ-G_xBniIqb w0Ls1jF44-csFCur-kEgU8awapJzKnqDKgw"}]}}},"schema":{"$ref":"#/components/schemas/JwksResponse"}}},"description":"Integrity keys successfully retrieved","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"7f075cfc32601f69d5ed78afcf80e594317f50db5be21e7bd264ba075630dcff"}}}},"tags":["Keys"],"operationId":"getKeys","summary":"Retrieve Integrity Keys"}},"/ris/fourthline/workflows":{"post":{"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowSessionResponseDto"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/WorkflowSessionResponseDto"}}},"description":"Successful operation","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"928b1d02fdebbbc8009ec29e4e40fa07697632acce8e531e5e17272637b2c897"}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"examples":{"response":{"value":{"detail":"Failed to read request","instance":"/ris/fourthline/workflows","invalid-context":[{"expected":"number type","field":"identityData.address.streetNumber","reason":"Invalid format for input: [string]"}],"status":400,"title":"Bad Request","traceId":"4169b343fe50b61f56d2eea45654c05b","type":"urn:ris:error:input-validation"}}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Bad request","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"928b1d02fdebbbc8009ec29e4e40fa07697632acce8e531e5e17272637b2c897"}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"examples":{"response":{"value":{"authorization-error":"Unauthorized","detail":"Failure while processing the request!","instance":"/ris/fourthline","status":401,"title":"Unauthorized","traceId":"79c50d0b82206e76192f7de64d42e2d4","type":"urn:ris:error:unauthorized"}}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"928b1d02fdebbbc8009ec29e4e40fa07697632acce8e531e5e17272637b2c897"}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"examples":{"response":{"value":{"detail":"Failure while processing the request!","instance":"/ris/fourthline","status":500,"title":"Internal Server Error","traceId":"327725e316216679503dd9667256e02f","type":"about:blank"}}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"A general problem with the server.","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"928b1d02fdebbbc8009ec29e4e40fa07697632acce8e531e5e17272637b2c897"}}}},"tags":["Identity Verification"],"operationId":"startIdentityVerificationCase","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowSessionRequestDto"}}},"required":true},"summary":"Create workflow"}},"/ris/fourthline/workflows/{workflowId}":{"get":{"parameters":[{"example":"f5d02f64-d053-4ab2-af5f-9b4be4281f19","in":"path","name":"workflowId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaseStatusResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/CaseStatusResponse"}}},"description":"Successful operation","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"2d02c08d54dfd7b4c0bb56641b9c184dd1719fb636c24dae6f119d9792a92f5d"}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"examples":{"response":{"value":{"authorization-error":"Unauthorized","detail":"Failure while processing the request!","instance":"/ris/fourthline","status":401,"title":"Unauthorized","traceId":"79c50d0b82206e76192f7de64d42e2d4","type":"urn:ris:error:unauthorized"}}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"2d02c08d54dfd7b4c0bb56641b9c184dd1719fb636c24dae6f119d9792a92f5d"}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"examples":{"response":{"value":{"detail":"Failure while processing the request!","instance":"/ris/fourthline","not-found-error":"Resource not found [f0ecc204-e43b-444c-ae37-4d45ff3b2897]","status":404,"title":"Resource not found","traceId":"c5d22a80461c552b3b7d1f8d6adee532","type":"urn:ris:error:not-found"}}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Resource not found","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"2d02c08d54dfd7b4c0bb56641b9c184dd1719fb636c24dae6f119d9792a92f5d"}}},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"examples":{"response":{"value":{"detail":"Failure while processing the request!","instance":"/ris/fourthline","status":500,"title":"Internal Server Error","traceId":"327725e316216679503dd9667256e02f","type":"about:blank"}}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"A general problem with the server.","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"2d02c08d54dfd7b4c0bb56641b9c184dd1719fb636c24dae6f119d9792a92f5d"}}}},"tags":["Identity Verification"],"operationId":"getCaseStatus","summary":"Get case status"}},"/ris/fourthline/workflows/testoutcome/{workflowId}":{"post":{"tags":["Identity Verification"],"summary":"Set case outcome","operationId":"setTestOutcome","parameters":[{"name":"workflowId","in":"path","required":true,"schema":{"type":"string"},"example":"f5d02f64-d053-4ab2-af5f-9b4be4281f19"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestOutcomeRequest"}}},"required":true},"responses":{"204":{"description":"Successful operation","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"ca9361b9bf23badf09577d414f5d783adcfad2dbbb971752dd19150c70d461a6"}}},"400":{"description":"Bad request","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"ca9361b9bf23badf09577d414f5d783adcfad2dbbb971752dd19150c70d461a6"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"type":"urn:ris:error:input-validation","title":"Bad Request","status":400,"detail":"Failed to read request","instance":"/ris/fourthline/workflows/testoutcome/c4a83875-7504-413f-ae32-a82a99c2c0e1","invalid-context":[{"field":"expectations","reason":"Invalid format for input: [unknown]","expected":["pending"]}],"traceId":"631379e6d43d77541346bec1a091a5f5"}}}},"401":{"description":"Unauthorized","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"ca9361b9bf23badf09577d414f5d783adcfad2dbbb971752dd19150c70d461a6"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"type":"urn:ris:error:unauthorized","title":"Unauthorized","status":401,"detail":"Failure while processing the request!","instance":"/ris/fourthline","authorization-error":"Unauthorized","traceId":"79c50d0b82206e76192f7de64d42e2d4"}}}},"500":{"description":"A general problem with the server.","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"ca9361b9bf23badf09577d414f5d783adcfad2dbbb971752dd19150c70d461a6"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"example":{"type":"about:blank","title":"Internal Server Error","status":500,"detail":"Failure while processing the request!","instance":"/ris/fourthline","traceId":"327725e316216679503dd9667256e02f"}}}}}}},"/ris/fourthline/workflows/{workflowId}/results/{format}":{"get":{"parameters":[{"example":"f5d02f64-d053-4ab2-af5f-9b4be4281f19","in":"path","name":"workflowId","required":true,"schema":{"type":"string"}},{"example":"pdf or zip","in":"path","name":"format","required":true,"schema":{"type":"string"}},{"example":"{\n  \"alg\": \"RSA-OAEP\",\n  \"e\": \"AQAB\",\n  \"kty\": \"RSA\",\n  \"n\": \"sO3DbtMN5-ukRPrGaz5PpK_acCOQ-X5s-YeIbLNyl9jxqz36G_rANhUzeDcmkCexFTXCn-_VTziK6EFYwfNe7_7ZMLdF4JFgthEckqgRHKtLsgK4knEsB5xzSMloIQ0A59IBRKClZHmqNT1TJCRJL0UjUyVdxaEwwLh2Ow1n96Xeb7PFyk38HJnRFpEASZDwBYCLF7wupxucx4PYwH4rnCFCCpc_cV-oU_uIGfj0TbilTX0E64OE5NX9V1JF0Bj0xZAa47H3rblxE-6qxHKUwCy1mNtDo43E4qhbZnFo-FiFI-UQ1bBsbklmVDVDdtdWsWo9g2Fzu3y0KOVNjRHqNQ\",\n  \"use\": \"enc\"\n}","in":"header","name":"X-Encryption-Key","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/octet-stream":{"schema":{"example":"binary data","format":"byte","type":"string"}},"application/problem+json":{"schema":{"example":"binary data","format":"byte","type":"string"}}},"description":"Successful operation","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"c08a63f1c1b7c7276a3705730ddd984c520e4256c74c15e9966464694ed4316d"}}},"401":{"content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"examples":{"response":{"value":{"authorization-error":"Unauthorized","detail":"Failure while processing the request!","instance":"/ris/fourthline","status":401,"title":"Unauthorized","traceId":"79c50d0b82206e76192f7de64d42e2d4","type":"urn:ris:error:unauthorized"}}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Unauthorized","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"c08a63f1c1b7c7276a3705730ddd984c520e4256c74c15e9966464694ed4316d"}}},"404":{"content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"examples":{"response":{"value":{"detail":"Failure while processing the request!","instance":"/ris/fourthline/workflows/1/results/pdf","not-found-error":"Invalid verification status for this request","status":404,"title":"Resource not found","traceId":"4c8e3fe18e52df46797d03e78d3b7c07","type":"urn:ris:error:not-found"}}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"Resource not found","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"c08a63f1c1b7c7276a3705730ddd984c520e4256c74c15e9966464694ed4316d"}}},"500":{"content":{"application/octet-stream":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"examples":{"response":{"value":{"detail":"Failure while processing the request!","instance":"/ris/fourthline","status":500,"title":"Internal Server Error","traceId":"327725e316216679503dd9667256e02f","type":"about:blank"}}},"schema":{"$ref":"#/components/schemas/ErrorResponse"}}},"description":"A general problem with the server.","headers":{"X-Trace-Id":{"description":"Correlation id per request/response for debug purpose","schema":{"type":"string"},"x-example":"c08a63f1c1b7c7276a3705730ddd984c520e4256c74c15e9966464694ed4316d"}}}},"tags":["Identity Verification"],"operationId":"getResults","summary":"Get verification outcome"}}},"components":{"schemas":{"Address":{"properties":{"city":{"description":"The city of the client’s address","example":"Utrecht","type":"string"},"country":{"description":"The country of the client’s address","example":"NLD","type":"string"},"postalCode":{"description":"The zip code of the client’s address","example":"3521CB","type":"string"},"region":{"description":"The region of the client’s address","example":"Utrecht","type":"string"},"secondAddressLine":{"description":"The second line of the client’s address","example":"Croeselaan","type":"string"},"street":{"description":"The street of the client’s address","example":"Croeselaan","type":"string"},"streetNumber":{"description":"The street number of the client’s address","example":18,"format":"int32","type":"integer"},"streetNumberPrefix":{"description":"The prefix of the street number","example":"A","type":"string"},"streetNumberSuffix":{"description":"The suffix of the street number","example":"A","type":"string"}},"type":"object"},"AddressDto":{"properties":{"city":{"description":"The city of the client’s address","example":"Utrecht","type":"string"},"country":{"description":"The country of the client’s address","example":"NLD","pattern":"^[A-Z]{3}$","type":"string"},"postalCode":{"description":"The zip code of the client’s address","example":"3521CB","type":"string"},"street":{"description":"The street of the client’s address","example":"Croeselaan","type":"string"},"streetNumber":{"description":"The street number of the client’s address","example":18,"format":"int32","minimum":0,"type":"integer"},"streetNumberSuffix":{"description":"The suffix of the street number","example":"A","type":"string"}},"required":["city","country","postalCode","street","streetNumber"],"type":"object"},"CaseExpectation":{"required":["responseDetails"],"type":"object","properties":{"responseDetails":{"type":"array","description":"The outcome to apply to the case when it reaches the specified status","items":{"$ref":"#/components/schemas/ResponseDetail"}}},"description":"Map of expectations with available keys: 'pending'","example":{"pending":{"responseDetails":[{"statusCode":200}]}}},"CaseStatusResponse":{"properties":{"data":{"$ref":"#/components/schemas/Data"},"dataValidationError":{"additionalProperties":{"$ref":"#/components/schemas/ValidationError"},"description":"Information about errors found while validating the data","example":{"ageOver18":{"created":"02/14/2019 14:28:06","error":"Client is not older than 18 years","errorCode":1034,"status":"error"}},"type":"object"},"hash":{"description":"The hash for the case zipfile","example":"8f15a543ab4eff7d75629d680c9489b1","type":"string"},"message":{"$ref":"#/components/schemas/Message"},"processType":{"description":"The case type: NaturalPersons: Identity Verification case","example":"NaturalPersons","type":"string"},"riskInfo":{"$ref":"#/components/schemas/RiskInfo"},"verificationId":{"description":"Unique identifier for the Identity Verification case, is the same as workflowId","example":"f5d02f64-d053-4ab2-af5f-9b4be4281f19","type":"string"},"verificationStatus":{"description":"The case status","example":"new","type":"string"}},"type":"object"},"Data":{"properties":{"analyst":{"description":"The identifier of the human agent who processed the case","example":"SNCA00001","type":"string"},"clientNumberProvider":{"description":"Unique identifier for the client","example":"ad45008c-222f-4783-80af-768abfd2a5b1","type":"string"},"messages":{"items":{"$ref":"#/components/schemas/DataMessage"},"type":"array"},"modifiedDateTime":{"description":"The timestamp for when the data was last modified","example":"2019-01-17T07:24:30Z","type":"string"},"riskCategory":{"description":"The risk category","example":"ACCEPTED","type":"string"},"userData":{"$ref":"#/components/schemas/UserData"}},"type":"object"},"DataMessage":{"properties":{"areaOfAttention":{"description":"The data point in the case that threw the error","example":"Quality of identification document","type":"string"},"description":{"description":"The status code description.","example":"ID document quality - too blurry","type":"string"},"statusCode":{"description":"The case status code","example":"3202","type":"string"}},"type":"object"},"Device":{"properties":{"deviceMetaData":{"$ref":"#/components/schemas/DeviceMetaData"}},"type":"object"},"DeviceMetaData":{"properties":{"ipAddress":{"description":"The IP address of the client’s device","example":"185.128.27.102","type":"string"}},"type":"object"},"EmailAndPhone":{"properties":{"email":{"description":"The client’s email address","example":"example@example.com","type":"string"},"mobile":{"description":"The client’s mobile phone number","example":"+324123456789","type":"string"},"phone":{"description":"The client’s phone number","example":"+324123456789","type":"string"}},"type":"object"},"EmailAndPhoneDto":{"properties":{"email":{"description":"The client’s email address","example":"example@example.com","pattern":"^[\\w+-.]+@([\\w-]+.)+[\\w-]{2,30}$","type":"string"},"mobile":{"description":"The client’s mobile phone number","example":"+324123456789","pattern":"^(00|\\+)\\d{10,14}$","type":"string"}},"required":["email","mobile"],"type":"object"},"ErrorResponse":{"properties":{"detail":{"description":"Detail of the error","example":"Failure while processing the request!","type":"string"},"instance":{"description":"Instance of the error","example":"/ris/resource/d5cc0517-4e2b-4e80-8442-46a5a130b03e","type":"string"},"status":{"description":"Status of the error","example":400,"format":"int32","type":"integer"},"title":{"description":"Tittle of the error","example":"Internal Server Error","type":"string"},"traceId":{"description":"Id of the error, so that it can be investigated on the persisted logs","example":"40b664267dbf2e1cec98de4a733bbd01","type":"string"},"type":{"description":"Type of the error","example":"urn:ris:error:input-validation","type":"string"}},"type":"object"},"File":{"properties":{"fileLocation":{"description":"Where the identity file is located","example":"frontPassport.jpeg","type":"string"},"fileType":{"description":"The identity file type, e.g. JPG","example":"JPG","type":"string"},"id":{"description":"Unique identifier for the file","example":"15d1eb58-59da-415f-bbe7-421fdc6fc199","type":"string"},"side":{"description":"The side of the ID document shown","example":"Front","type":"string"}},"type":"object"},"IdentityDataRequestDto":{"properties":{"address":{"$ref":"#/components/schemas/AddressDto"},"emailAndPhone":{"$ref":"#/components/schemas/EmailAndPhoneDto"}},"type":"object"},"IdentityDocument":{"properties":{"address":{"$ref":"#/components/schemas/Address"},"device":{"$ref":"#/components/schemas/Device"},"tax":{"$ref":"#/components/schemas/Tax"},"documents":{"items":{"$ref":"#/components/schemas/IdentityFilesInfo"},"type":"array"},"emailAndPhone":{"$ref":"#/components/schemas/EmailAndPhone"},"latitude":{"type":"string","description":"GPS latitude coordinate of the verification","example":"52.0839"},"longitude":{"type":"string","description":"GPS longitude coordinate of the verification","example":"5.115"},"person":{"$ref":"#/components/schemas/Person"},"rawVizReading":{"example":[{"fieldName":"FirstName","fieldValue":"WILLEKÉ LISELÖTTE"},{"fieldName":"GivenNames","fieldValue":"DÖ BRUIJN"},{"fieldName":"DateOfBirth","fieldValue":"650310"},{"fieldName":"Gender","fieldValue":"F"},{"fieldName":"PlaceOfBirth","fieldValue":"SPECIMEN"},{"fieldName":"Nationality","fieldValue":"NËDÉRLÁNDSE"},{"fieldName":"CountryCode","fieldValue":"NÈD"},{"fieldName":"DocumentNumber","fieldValue":"SPÉCI2014"},{"fieldName":"IssueDate","fieldValue":"140309"},{"fieldName":"ExpiryDate","fieldValue":"240309"},{"fieldName":"DocumentType","fieldValue":"P"}],"items":{"$ref":"#/components/schemas/RawVizReading"},"type":"array"}},"type":"object"},"IdentityFilesInfo":{"properties":{"documentIssuingCountry":{"description":"The country that issued the document","example":"NLD","type":"string"},"documentNumber":{"description":"The number of the client’s ID document","example":"SPECI2021","type":"string"},"documentSubType":{"description":"For Physical Proof of Address, any further sub-classification of this document type","example":"Utility bill","type":"string"},"documentType":{"description":"The ID document type","example":"Passport","type":"string"},"expirationDate":{"description":"The date the ID document expires","example":"2031-08-30","type":"string"},"files":{"items":{"$ref":"#/components/schemas/File"},"type":"array"},"holderName":{"description":"For Physical Proof of Address, the name of the person the document was issued to","example":"WILLEKE DE BRUIJN","type":"string"},"issueDate":{"description":"The date the ID document was issued","example":"2021-08-30","type":"string"},"residenceAddress":{"description":"The raw, unverified address extracted from the ID document","example":"Croeselaan 18 A UTRECHT","type":"string"},"validityInDays":{"description":"For Physical Proof of Address, the number of days the document is valid for","example":90,"format":"int32","type":"integer"}},"type":"object"},"JwksResponse":{"description":"JWKSet keys response","properties":{"keys":{"items":{"properties":{},"type":"object"},"type":"array"}},"required":["keys"],"type":"object"},"Message":{"properties":{"description":{"description":"The status code description","example":"You have started the verification process and we are validating the data","type":"string"},"statusCode":{"description":"The case status code","example":1000,"format":"int32","type":"integer"}},"type":"object"},"Person":{"properties":{"birthDate":{"description":"The client’s date of birth","example":"1965-03-10","type":"string"},"countryOfBirth":{"description":"The country where the client was born","example":"NLD","type":"string"},"firstName":{"description":"The client’s first name","example":"WILLEKE LISELOTTE","type":"string"},"gender":{"description":"The client’s gender","example":"Female","type":"string"},"initials":{"description":"The client’s initials","example":"WLB","type":"string"},"lastName":{"description":"The client’s last name","example":"DE BRUIJN","type":"string"},"middleName":{"description":"The client’s middle name","example":"LISELOTTE","type":"string"},"name":{"description":"The client’s full name","example":"WILLEKE LISELOTTE DE BRUIJN","type":"string"},"nationality":{"description":"The client’s nationality","example":"NLD","type":"string"},"placeOfBirth":{"description":"The city where the client was born","example":"Utrecht","type":"string"},"type":{"description":"The type of entity the client is","example":"Natural Person","type":"string"}},"type":"object"},"RawVizReading":{"example":[{"fieldName":"FirstName","fieldValue":"WILLEKÉ LISELÖTTE"},{"fieldName":"GivenNames","fieldValue":"DÖ BRUIJN"},{"fieldName":"DateOfBirth","fieldValue":"650310"},{"fieldName":"Gender","fieldValue":"F"},{"fieldName":"PlaceOfBirth","fieldValue":"SPECIMEN"},{"fieldName":"Nationality","fieldValue":"NËDÉRLÁNDSE"},{"fieldName":"CountryCode","fieldValue":"NÈD"},{"fieldName":"DocumentNumber","fieldValue":"SPÉCI2014"},{"fieldName":"IssueDate","fieldValue":"140309"},{"fieldName":"ExpiryDate","fieldValue":"240309"},{"fieldName":"DocumentType","fieldValue":"P"}],"properties":{"fieldName":{"description":"The extracted field from the ID document","example":"FirstName","type":"string"},"fieldValue":{"description":"The value of extracted field from the ID document","example":"WILLEKÉ LISELÖTTE","type":"string"}},"type":"object"},"ResponseDetail":{"required":["statusCode"],"type":"object","properties":{"statusCode":{"type":"string","description":"The status code that applies the outcome when the case reaches the specified status","example":"200","enum":["200","4110","5100","2001","2002","2003","3001","3002","3003","3005","3100","3101","3102","3103","3104","3105","3200","3201","3202","3203","3204","3205","3300","3304","3305","3306","3307","3400","3401","3402","3403","3405","3406"]}},"description":"The outcome to apply to the case when it reaches the specified status"},"RiskInfo":{"properties":{"description":{"description":"The case risk score description","example":"Medium","type":"string"},"statusCode":{"description":"The case risk code","example":200,"format":"int32","type":"integer"}},"type":"object"},"Tax":{"type":"object","properties":{"tin":{"type":"string","description":"The Taxpayer Identification Number (TIN). In the Netherlands, this field represents the 'Burgerservicenummer'.","example":"999999990"},"usTIN":{"type":"string","description":"The client’s US TIN"},"usPerson":{"type":"string","description":"Whether the client is a US citizen.","example":"no","enum":["no","yes"]},"countrySubjectToTaxation":{"type":"string","description":"The country where the client is subject to taxation. Format: ISO 3166-1 alpha-3","example":"NLD"}}},"SessionRequestDto":{"properties":{"target":{"description":"The type of SDK session","enum":["web","mobile"],"example":"web","type":"string"}},"required":["target"],"type":"object"},"SessionResponseDto":{"properties":{"expiryDateTime":{"description":"The timestamp for when the validation code expires (2 hours after creation)","example":"2024-08-06T20:42:02.4093721+00:00","type":"string"},"validationCode":{"description":"The single-use validation code to link the SDK session to the workflow","example":"99992DFD","type":"string"}},"type":"object"},"TestOutcomeRequest":{"required":["expectations"],"type":"object","properties":{"expectations":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/CaseExpectation"},"description":"Map of expectations with available keys: 'pending'","example":{"pending":{"responseDetails":[{"statusCode":200}]}}}},"description":"Request object for setting case outcomes"},"UserData":{"properties":{"document":{"$ref":"#/components/schemas/IdentityDocument"}},"type":"object"},"ValidationError":{"description":"Information about errors found while validating the data","example":{"ageOver18":{"created":"02/14/2019 14:28:06","error":"Client is not older than 18 years","errorCode":1034,"status":"error"}},"properties":{"created":{"description":"The error timestamp","example":"02/14/2024 14:28:06","type":"string"},"error":{"description":"The error message","example":"Client is not older than 18 years","type":"string"},"errorCode":{"description":"The error code relating to the property","example":1034,"format":"int32","type":"integer"},"status":{"description":"The status of the property","example":"error","type":"string"}},"type":"object"},"WorkflowRequestDto":{"properties":{"providerClientId":{"description":"A unique identifier for your user, make sure to provide a unique value for every identification","example":"ad45008c-222f-4783-80af-768abfd2a5b1","type":"string"},"workflowName":{"description":"The type of workflow","enum":["IDV"],"example":"IDV","type":"string"},"branch":{"description":"Your configuration for this product. Set the string provided by you during the onboarding phase","example":"default","type":"string"}},"required":["providerClientId","workflowName"],"type":"object"},"WorkflowSessionRequestDto":{"properties":{"identityData":{"$ref":"#/components/schemas/IdentityDataRequestDto"},"session":{"$ref":"#/components/schemas/SessionRequestDto"},"workflow":{"$ref":"#/components/schemas/WorkflowRequestDto"}},"required":["session","workflow"],"type":"object"},"WorkflowSessionResponseDto":{"properties":{"clientId":{"description":"Unique identifier for the client","example":"a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6","type":"string"},"session":{"$ref":"#/components/schemas/SessionResponseDto"},"workflowId":{"description":"Unique identifier for the workflow","example":"f5d02f64-d053-4ab2-af5f-9b4be4281f19","type":"string"}},"type":"object"}},"securitySchemes":{"clientId":{"description":"ClientId as provided by the Rabobank developer portal.","in":"header","name":"X-IBM-Client-Id","type":"apiKey"}}},"security":[{"clientId":[]}],"x-components":{},"x-readme":{"explorer-enabled":false,"proxy-enabled":false}}