openapi-directory
Version:
Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS
1 lines • 5.62 kB
JSON
{"openapi":"3.0.0","info":{"contact":{"x-twitter":"HMLandRegistry"},"description":"Land Registry Deed API","title":"Deed API","version":"1.0.0","x-apisguru-categories":["open_data"],"x-logo":{"url":"https://twitter.com/HMLandRegistry/profile_image?size=original"},"x-origin":[{"format":"swagger","url":"https://raw.githubusercontent.com/LandRegistry/dm-deed-api/master/application/deed/schemas/deed-api.json","version":"2.0"}],"x-providerName":"landregistry.gov.uk","x-serviceName":"deed"},"paths":{"/deed/":{"post":{"description":"The post Deed endpoint creates a new deed based on the JSON provided.\n The reponse will return a URL that can retrieve the created deed. \n > REQUIRED: Land Registry system requests Conveyancer to confirm that the Borrowers identity has been established in accordance with Section 111 of the Network Access Agreement.","operationId":"addDeed","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deed_Application"}}},"required":true},"responses":{"201":{"description":"URL to the GET endpoint for the deed is returned on successful creation.\n","content":{"text/plain":{"schema":{"type":"string"}}}},"400":{"description":"Bad Request due to invalid schema. Response will include 1 or more schema errors\n","content":{"text/plain":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"summary":"Deed"}},"/deed/{deed_reference}":{"get":{"description":"The Deed endpoint returns details of a specific deed based on the unique deed reference.\nThe response includes the Title Number, Property information, Borrower(s) information and deed information.\n","parameters":[{"description":"Unique reference of the deed.","in":"path","name":"deed_reference","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"A specific deed is returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operative_Deed"}}}},"404":{"description":"Deed not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"summary":"Deed","tags":["Deed"]}}},"servers":[{"url":"https://api.landregistry.gov.uk/v1"}],"components":{"schemas":{"AdditionalProvisions":{"items":{"properties":{"additional_provision_code":{"type":"string"},"description":{"type":"string"}},"type":"object"},"minItems":0,"type":"array"},"Borrower":{"properties":{"forename":{"pattern":"^(?!\\s*$).+","type":"string"},"id":{"pattern":"^[0-9]+$","type":"string"},"middle_name":{"pattern":"^(?!\\s*$).+","type":"string"},"surname":{"pattern":"^(?!\\s*$).+","type":"string"},"token":{"pattern":"^([a-zA-Z0-9]{8})$","type":"string"}},"required":["surname","forename","id","token"],"type":"object"},"Borrowers":{"items":{"$ref":"#/components/schemas/PrivateIndividualName"},"minItems":1,"type":"array"},"ChargeClause":{"properties":{"cre_code":{"type":"string"},"description":{"type":"string"}},"type":"object"},"Deed_Application":{"properties":{"borrowers":{"$ref":"#/components/schemas/Borrowers"},"identity_checked":{"pattern":"^[Y]$","type":"string"},"md_ref":{"pattern":"^e-MD([0-9]{5}|([0-9]{3,4}[A-Z]{1}))$","type":"string"},"property_address":{"description":"The address of property that the deed relates. This should be supplied in a comma separated format e.g. 30 wakefield rd, plymouth, PL6 3WA","pattern":"^(?!\\s*$).+","type":"string"},"title_number":{"pattern":"^([A-Z]{0,3}[1-9][0-9]{0,5}|[0-9]{1,6}[ZT])$","type":"string"}},"required":["title_number","borrowers","md_ref","identity_checked","property_address"],"type":"object"},"Error":{"properties":{"code":{"format":"int32","type":"integer"},"message":{"type":"string"}},"type":"object"},"Lender":{"properties":{"address":{"type":"string"},"description":{"type":"string"},"name":{"type":"string"}},"type":"object"},"OpBorrowers":{"items":{"$ref":"#/components/schemas/Borrower"},"minItems":1,"type":"array"},"Operative_Deed":{"properties":{"deed":{"description":"Unique deed, consisting of property, borrower and charge information as well as clauses for the deed.","properties":{"additional_provisions":{"$ref":"#/components/schemas/AdditionalProvisions"},"borrowers":{"$ref":"#/components/schemas/OpBorrowers"},"charge_clause":{"$ref":"#/components/schemas/ChargeClause"},"deed_status":{"description":"Current state of the deed","type":"string"},"effective_clause":{"description":"Text to display the make effective clause","type":"string"},"lender":{"$ref":"#/components/schemas/Lender"},"md_ref":{"description":"Land Registry assigned number for a Mortgage Deed (MD). If you wish to use an existing MD reference please prefix it with e- to comply with our system (eg e-MD12345)","type":"string"},"property_address":{"description":"The address of property that the deed relates. This should be supplied in a comma separated format e.g. 30 wakefield rd, plymouth, PL6 3WA","type":"string"},"title_number":{"description":"Unique Land Registry identifier for the registered estate.","type":"string"}},"type":"object"}},"type":"object"},"PrivateIndividualName":{"additionalProperties":false,"properties":{"address":{"pattern":"[A-Z]{1,2}[0-9R][0-9A-Z]? [0-9](?:A-Z-245|[^CIKMOV]){2}","type":"string"},"dob":{"pattern":"^(0[1-9]|[12][0-9]|3[01])[\\/\\-](0[1-9]|1[012])[/\\-]\\d{4}$","type":"string"},"forename":{"pattern":"^(?!\\s*$).+","type":"string"},"gender":{"enum":["Male","Female","Not Specified"],"type":"string"},"middle_name":{"pattern":"^(?!\\s*$).+","type":"string"},"phone_number":{"pattern":"^(07[\\d]{9})$","type":"string"},"surname":{"pattern":"^(?!\\s*$).+","type":"string"}},"required":["surname","forename","dob","phone_number","address"],"type":"object"}}}}