{"method":"GET","path":"https://api.revcent.com/v2/secure_forms/{secure_form_id}","summary":"Get A Secure Form","description":"Retrieve the details of a specific secure form. View markdown documentation at https://revcent.com/documentation/markdown/mcp/operation/GetSecureForm.md for an in-depth overview of this operation.","operationId":"GetSecureForm","parameters":[{"in":"path","name":"secure_form_id","description":"The secure form ID.","required":true,"schema":{"type":"string","description":"A 20 character secure form ID.","minLength":20,"maxLength":20}}],"requestBody":{"content":{"application/x-www-form-urlencoded":{"encoding":{},"schema":{"additionalProperties":false,"properties":{},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"allOf":[{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"The API call response code, 1 = Success","type":"integer","enum":[1]}},"title":"APICallResponseInfo","type":"object","additionalProperties":false},{"type":"object","additionalProperties":false,"properties":{"created_date_unix":{"description":"The unix timestamp of when the item was created.","type":"integer","format":"unix-time"},"id":{"type":"string","description":"A 20 character secure form ID.","minLength":20,"maxLength":20},"completed":{"description":"Whether the secure form has been completed by the user. i.e. the form fields were filled in, form submitted and secure form data is encrypted and saved internally by RevCent. Once a secure form has been completed it cannot be modified.","type":"boolean"},"form_source":{"type":"string","description":"The form source, indicating the source in which the form fields should be generated.","enum":["third_party_integration","third_party_shop","gateway","fulfillment_center","smtp_profile","paypal_account"]},"form_source_id":{"type":"string","description":"The form source id which indicates the site ID of the form_source, only applicable to a form_source of third_party_integration, third_party_shop, gateway or fulfillment_center. Not applicable to form source of smtp_profile or paypal_account.<br><br>For example, if form_source is third_party_integration, then form_source_id would be the site_third_party_integration ID, indicating the secure form should be generated using the required fields for a specific site third party integration.<br><br> Form Source ID Map:<br><br><em>third_party_integration:</em> the site third party integration ID.<br><br><em>third_party_shop:</em> the site third party shop ID.<br><br><em>gateway:</em> the site gateway ID.<br><br><em>fulfillment_center:</em> the site fulfillment center ID.","minLength":20,"maxLength":20},"form_url":{"type":"string","description":"The secure form URL. This is the URL that the user should be directed to in order to fill out and complete the secure form, if not completed already. The user must be logged into RevCent in order to access the secure form.","format":"uri"},"expiration_date_unix":{"type":"integer","format":"unix-time","description":"The unix timestamp representing the secure form expiration. After this time, the secure form URL will no longer be valid and the user will not be able to fill out the form or access any information related to the secure form."},"updated_date_unix":{"description":"The unix timestamp of when the item was last updated.","type":"integer","format":"unix-time"}}}]}}},"description":"Successful response."},"default":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"This value indicates that there is an error. Will always be 0.","type":"integer","enum":[0]},"error_code":{"description":"The specific error code.","type":"string"},"message":{"description":"A human readable description of the error.","type":"string"},"result":{"description":"A description of the API call result.","type":"string"}},"title":"APIStandardErrors","type":"object","additionalProperties":false}}},"description":"Error response."}}}