{"openapi":"3.0.2","info":{"title":"2Recover API Specification","description":"https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.2.md","version":"1.5.0"},"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"api-key"},"NonceHeader":{"type":"apiKey","in":"header","name":"api-nonce"},"SignatureHeader":{"type":"apiKey","in":"header","name":"api-signature"}}},"paths":{"/billing/balance":{"get":{"summary":"Get balance of the current organization","operationId":"getBalance","security":[{"ApiKeyHeader":[],"NonceHeader":[],"SignatureHeader":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"balance":{"type":"number"}}}}}}}}},"/billing/expenses":{"get":{"summary":"Get detailed expenses for the organization","operationId":"getExpenses","security":[{"ApiKeyHeader":[],"NonceHeader":[],"SignatureHeader":[]}],"parameters":[{"in":"query","name":"take","schema":{"type":"integer"},"required":false,"description":"The number of records to retrieve"},{"in":"query","name":"skip","schema":{"type":"integer"},"required":false,"description":"The number of records to skip"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"total_count":{"type":"integer"},"expenses":{"type":"array","items":{"type":"object"}}}}}}}}}},"/billing/expense_types":{"get":{"summary":"Get expense types and costs dictionary","operationId":"getTypes","security":[{"ApiKeyHeader":[],"NonceHeader":[],"SignatureHeader":[]}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"expense_types":{"type":"object"}}}}}}}}},"/ping":{"get":{"summary":"Check API status","operationId":"ping","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"Pong":{"type":"boolean"}}}}}}}}},"/customer/create_without_verification":{"post":{"summary":"Deprecated. Create a customer without phone number verification, used for initial migration","operationId":"createWithoutVerification","security":[{"ApiKeyHeader":[],"NonceHeader":[],"SignatureHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phone":{"type":"string"},"email":{"type":"string"},"language":{"type":"string"},"user_id":{"type":"string","description":"UUID of the user in your system, must be unique"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"}}}}}}}}},"/customer/create":{"post":{"summary":"Create a customer with the provided information (primary flow)","operationId":"create","security":[{"ApiKeyHeader":[],"NonceHeader":[],"SignatureHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phone":{"type":"string"},"email":{"type":"string"},"language":{"type":"string"},"via":{"type":"string","description":"sms, telegram"},"user_id":{"type":"string","description":"UUID of the user in your system, must be unique"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"makenoise_id":{"type":"string"},"error":{"type":"string"}}}}}}}}},"/customer/add_user_contract":{"post":{"summary":"Add a user wallet contract to the customer","operationId":"addUserContract","security":[{"ApiKeyHeader":[],"NonceHeader":[],"SignatureHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userContractAddress":{"type":"string"},"hexData":{"type":"string"},"cosignerAddress":{"type":"string"},"user_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"userContract":{"type":"string"},"serverSignature":{"type":"object","properties":{"nonce":{"type":"string"},"signed_data":{"type":"object","properties":{"v":{"type":"integer"},"r":{"type":"string"},"s":{"type":"string"}}}}}}}}}}}}},"/customer/request_code":{"post":{"summary":"Request a code for the customer (1st step of recovery)","operationId":"requestCode","security":[{"ApiKeyHeader":[],"NonceHeader":[],"SignatureHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"hexData":{"type":"string"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"error":{"type":"string"},"makenoise_id":{"type":"string"}}}}}}}}},"/customer/confirm_with_code":{"post":{"summary":"Confirm registration or recovery with the code provided by customer (2nd step of process)","operationId":"confirmWithCode","security":[{"ApiKeyHeader":[],"NonceHeader":[],"SignatureHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_id":{"type":"string"},"code":{"type":"string"},"makenoise_id":{"type":"string"}}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"signedOperations":{"type":"array","items":{"type":"object","properties":{"nonce":{"type":"string"},"signed_data":{"type":"object","properties":{"v":{"type":"integer"},"r":{"type":"string"},"s":{"type":"string"}}},"userContract":{"type":"string"}}}}},"example":{"success":true,"signedOperations":[{"nonce":"704","signed_data":{"v":28,"r":"0x746f3d63b25b2e1ea0f2a3fc0915ed21c771204366d3356973db61d2d7f99906","s":"0x6592fba6c9b9b9bceb8332941f13b1b8437bcaf40b237fef3b61007e2e12c4f4"},"userContract":"0x655ea1ea2c3e733117d8928ecfd17cc2c95fafdc","cosigner":"0x43aBA81a812e77b1d73d97432F5367196d6DB375"},{"nonce":"705","signed_data":{"v":28,"r":"0x4a9a6fe29c677c3faf56e05b225e04ad39d70b19744751355ea4407ffccf9a42","s":"0xbce26f756f2297ba5082835aabc3e1c1822cfa9eb8cc7395a2dcc8078a2fcaa2"},"userContract":"0x111ea1ea2c3e733117d8928ecfd17cc2c95fa111","cosigner":"0x222BA81a812e77b1d73d97432F5367196d6DB222"}]}}}}}}}}},"servers":[{"url":"https://api.stage.2recover.it/api/{version}","description":"Staging","variables":{"version":{"default":"v1"}}},{"url":"https://api.2recover.it/api/{version}","description":"Production","variables":{"version":{"default":"v1"}}}]}