{"type":"api","title":"Export Ownership Voucher data","meta":{"id":"/apps/pubhub/media/crosswork-network-controller-7-1/f445c17e25a1120e8fbde4bd413083d0fd88b2b3/d1c072e8-3151-3b90-a574-d773df736b16","info":{"title":"Crosswork ZTP Service API","description":"Crosswork ZTP Service API for devices, profiles, serial numbers, and static routes. These APIs permit users to add, update, delete, query, and perform bulk CSV import/export of devices and device onboarding operations using ZTP services.","version":"7.1.0","contact":{"name":"Crosswork Team, Cisco","email":"support@cisco.com"},"license":{"name":"Cisco Software License Agreement","url":"http://www.cisco.com/public/sw-license-agreement.html"}},"security":[{"bearerAuth":[]}],"x-parser-conf":{"overview":{"markdownPath":"reference/EMF/ztp-service-api-overview.md"}},"openapi":"3.0.1","servers":[{"url":"/crosswork/ztp/v1"}],"securitySchemes":{"bearerAuth":{"description":"Security definitions details.","in":"header","name":"Authorization","type":"apiKey"}}},"spec":{"operationId":"ExportOwnershipVoucherData","requestBody":{"content":{"application/json":{"schema":{"description":"Serial Number Ownership Voucher (OV) request object.","properties":{"inputSerialNumbers":{"description":"List of Serial Number strings.","items":{"type":"string"},"type":"array"}},"type":"object","$$ref":"#/components/schemas/cwztpsvcZtpSerialNumberOVRequest"},"example":{"inputSerialNumbers":["AXKPG766608","AXKPG766688"]}}},"description":"The information used to export ownership voucher (OV) data.","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"description":"Serial Number Ownership Voucher (OV) response object.","properties":{"code":{"description":"Response code. Indicates success/failure.","format":"int32","type":"integer"},"data":{"description":"Ownership Voucher (OV) Base64 encoded data.","type":"string"},"message":{"description":"Response message. Indicates success/failure reason.","type":"string"}},"type":"object","$$ref":"#/components/schemas/cwztpsvcZtpSerialNumberOVResponse"},"examples":{"Success Response":{"summary":"Export OV Data Success","value":{"code":200,"message":"Export OV Data is successful","data":"eyJ2b3VjaGVyLXlucHV0Ijp7InNlcmlhAC1udW1iZXIiOiIxIiwicGlubmVkLWRvbwFpbi1jZXk0IjoiTUlJR1VqQ0NlRHFnQXdJQkFnSVJBLzk2WGt3eHJ2eitGRUh2VU4rZW8wd3dEUVlKS29aSWh2Y05BUUVMQlFBd2FERUxNQWtHQTFVRUJoTUNWVk14Q3pBSkJnTlZCQWdUQWtOQk1SRXdEd1lEVlFRSEV3aFRZVzRnU205elpURWFNQmdHQTFVRUNoTVJRMGxUUTA4Z1UxbFRWRVZOVXlCSlRrTXhIVEFiQmdOVkJBTVRGRnBVVUNCSmJuUmxjbTVoYkNCU2IyOTBJRU5CTUI0WERUSXlNRFV6TVRBM05UTXpPVm9YRFRJM01EVXpNREEzTlRNek9Wb3dhREVMTUFrR0ExVUVCaE1DVlZNeEN6QUpCZ05WQkFnVEFrTkJNUkV3RHdZRFZRUUhFd2hUWVc0Z1NtOXpaVEVhTUJnR0ExVUVDaE1SUTBsVFEwOGdVMWxUVkVWTlV5QkpUa014SFRBYkJnTlZCQU1URkZwVVVDQkpiblJsY201aGJDQlNiMjkwSUVOQk1JSUNJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBZzhBTUlJQ0NnS0NBZ0VBNENaSm1tbTRpRm5sSVd2N0RGQWNvOURER0FrQXVrRm9PanBObXZVQ3F0eXVrTTBQLzNJNmNMQ1lZVXk3Z3dnZ0pHaUZZR29Fam1NTjdiUm1NT2VydlFqT0JGdlpieXBKUjZBenpEaU9mTnJhUFNSYUp4N3J3Rkh6Sjd4VXdOdjY2d1I3d0VTa0hoWk9oSWkxQVVINFhnVE41dGQyTWRRZm5yRG9IZFNPRUdQMWtaVXdUK2FvZURkOGRtTmxrWnJCcHgxVlBsTnlWdjZmSzFzWVVSakFMRlZqNzRXNWczeklnZk5uU3ZmM2JLMmg1L2U5OGVFd044aXRXejdVNm9JSFhKMFdrQ0dkWmY2U2ZjaWJMbEtreEhaeDNlSFhWbzg4a2Q0bUducldkeHVQOEVJVDNEZUVEcTl0T3lBZWlvK24yQXNTa2RxZTlBTDJsVzNENmxGWkcxejRCZ1pNanRiV2pEN3ZsMHlwcnNuVkk5ak92UWRyajAyaWJka3FIYk43Zk00akNLSDJMdEp6M05hdVdQK2gvU2xPN1JMa2krMm1qUjZEeW9hR3FxUDFGcUFhQmJQTmsvSFg2ZEtLQVpIdGhuYTNia1pZd21LcTNaSmp0SlNZR3NuR05WRDRKNnlIZWM5c1hGMDdLMXJscTVtN2dKUFZsM0RXRW04TjhEK3E2K0htcksvazJGbmRYRjFzSTV2amdzSU9sMXZ1VGFrUDYzRlo3Y0dQcjBmQ0ZkVFRYNUNVZUIwYjJwRzJXNFVMR0V6aUQxMDg2b09lQjI1Qy9Ia0NUNnhudXVOZ1VxRnE0OHJUQTJuMlpEYS95T2FtSy9yS01lblcwdkpFYnJUNmhGQ2dic3oxemMyTldlNUxPZnQ3QmIrckpLay9SZEFhcGVTMUV5aThSeWNDQXdFQUFhT0I5akNCOHpBT0JnTlZIUThCQWY4RUJBTUNBWVl3SFFZRFZSMGxCQll3RkFZSUt3WUJCUVVIQXdJR0NDc0dBUVVGQndNQk1BOEdBMVVkRXdFQi93UUZNQU1CQWY4d0hRWURWUjBPQkJZRUZEUlJpZmRtNEJHSVdieW5DS1YrZUR5dnZEVkFNSUdSQmdOVkhSRUVnWWt3Z1lhQ0NrMWhibUZuWlcxbGJuU0NCRVJoZEdHQ0ZGcFVVQ0JKYm5SbGNtNWhiQ0JTYjI5MElFTkJnaWxrYjJOclpYSXRjbVZuYVhOMGNua3VaR1ZtWVhWc2RDNXpkbU11WTJ4MWMzUmxjaTVzYjJOaGJJSVRZM2N0WTJ4MWMzUmxjaTF0WjIxMExYWnBjSWNFQ2s0ZlJvY0V3S2hrMDRjRUNrNGZSNGNFQ2s0ZlNJY0VDazRmU1RBTkJna3Foa2lHOXcwQkFRc0ZBQU9DQWdFQWphSTM0ckFPakExWTByY1R1U3BQckJKei9rN01hL3NUMnM4RDIvNGV5ZTVNeXowNnhqbGtxTGd4bkNSaW9ycTkyTjg0bVAxOUp6VUp3QmZYbHhLcm51MHZTQTd0YTMyaDdKSS9pZm9pR2RkU2xIS3JKVklIMXhPM01mMExMZUVSU0k4UW1TUDNJa1lwMVR1dTdiN0Z6OTFSQ29YeXMvTEhyZ1dlUGJIMktWaG9uWXg2ZjJySmZIdXBONWZnM01ZNU1xSGJMRjRxQlFhWUQ5QUl1Si8vT3pCZU1OWDZQRTZIZHpPUjVZd1NWM2tBOHpTdlpZOW9DQ056WVBZRmxVRmhsM0JCNHMyVUZzNGRSZUY4NXNJK1VUeWp6T3dEdlA3VzZkS0gzYjMzOW8zSkZVTGp4Sk1oeGsvWDR6TlB1T3cxaU04R3JpYjFEbFpsYVFkVXpldVM0K083bHBTdWMweEI1TmN1bXRxMUI1SDhkR1cwVUF5Zzg1WUtsMTFPaVJxb3hwVTRrUzNlRjZGa3ZuR1JhT3hEdXE0SFV4MTJUQVB5dDFLeDI2Y3dUZGhkUUwrbmpwVFBFQ0dVQVNvZTErMm4yUjZFbml2dTAyZ00yYjl0MnVRcS96Q3FxWUI4U3ozSjhjQkNyMm9tWVZsRmc5OU9iWkJpUWR0U0dXdWtBTUVzMUsxMkNoNVFnM3B0RSs1YnlZN1RSdUx4L1E4TzN2U1ZtVWVwN3cvd2JKeHdQOHFoQ3YzOVNEdGx5aHVqVjZ6bjFMY0lpaUV3bDRUOFZvdUxGRFZtUlFZTXE0enBkeWNhOWlmUmdnM1NvMFBTSjVvUlpsYlB0TWNxeGhXNWdreDl2Sk9za0p5b2JwWnFFY2U3czBvVW92YWVPaHVqbTM2dDVtYmNJUmFvWUZ3PSJ9fQ=="},"$$ref":"#/components/examples/OV_Data_Export_Success"},"Serial Number Not Found":{"summary":"Serial Number Not Found","value":{"code":404,"message":"Unable to get the Serial Number(s)"},"$$ref":"#/components/examples/SN_Not_Found"},"Pinned Domain Certificate Not Found":{"summary":"Pinned Domain Certificate Not Found","value":{"code":404,"message":"unable to retrieve Pinned-domain-certificate as it is not found."},"$$ref":"#/components/examples/Pinned_Domain_Cert_Not_Found"},"Pinned Domain Certificate Parsing Failed":{"summary":"Pinned Domain Certificate Parsing Failed","value":{"code":500,"message":"failed to parse ZTP pinned domain CA cert. Error: x509: malformed certificate"},"$$ref":"#/components/examples/Pinned_Domain_Cert_Parsing_Failed"},"Invalid Request Body":{"summary":"Invalid Request Body","value":{"code":422,"message":"invalid character '}' looking for beginning of value"},"$$ref":"#/components/examples/Invalid_Request_Body"}}}},"description":"OK. The request was procesed. The result is contained in the response body."},"401":{"description":"Unauthorized. The request has not been applied because it lacks valid authentication credentials for the target resource."},"403":{"description":"Forbidden. The server recognizes the authentication credentials, but the client is not authorized to perform this request."},"404":{"description":"Not Found. The client made a request for a resource that does not exist."}},"summary":"Export Ownership Voucher data","description":"This API allows users to export Ownership Voucher data in JSON format, including device serial numbers and the pinned-domain-certificate. Response Body: cwztpsvcZtpSerialNumberOVResponse, contains the base64-encoded string content of the ownership voucher file.","tags":["Voucher & Serial Number APIs"],"__originalOperationId":"ExportOwnershipVoucherData","security":[{"bearerAuth":[]}],"method":"post","path":"/ovdata/export"}}