{"revision":"0ed62d2c742f8e20","language":"en","entry":{"id":"log-witnesses","kind":"endpoint","group":"log","title":"Read witness cosignatures","method":"GET","path":"/{log}/witnesses","paths":[],"summary":"Read each configured witness’s latest stored cosignature.","response":"JSON with origin, quorum and witnesses. Different witnesses may have signed different tree sizes.","parameters":[{"name":"log","description":"The log name identified by /v1/log, such as staging-1.","in":"path","required":true}],"sample":"/staging-1/witnesses","access":"public","base":"log","notes":[],"errors":[],"related":[],"sections":[{"kind":"code","language":"shell","code":"curl -fsS 'https://log.veil.rip/staging-1/witnesses'"}],"verify":"Verify each cosignature against the expected witness key and the checkpoint it signed.","live":false,"responses":[{"status":200,"contentType":"application/json","description":"JSON with origin, quorum and witnesses. Different witnesses may have signed different tree sizes.","fields":[{"name":"origin","type":"string","description":"Log origin."},{"name":"quorum","type":"integer","description":"Required witness count."},{"name":"witnesses","type":"array<LogWitness>","description":"Per-witness signed checkpoint information. Validate against the policy and signed notes."}]}],"responseObjects":[{"id":"log-witness","title":"Log witness","fields":[{"name":"name","type":"string","description":"Witness key name."},{"name":"vkey","type":"string","description":"Signed-note verifier key."},{"name":"url","type":"string","description":"Witness service URL."},{"name":"size","type":"integer","description":"Most recently cosigned tree size; witnesses can lag behind each other."},{"name":"checkpoint","type":"string","description":"Signed checkpoint associated with this witness."},{"name":"cosignature","type":"string","description":"Witness cosignature. Check it against the policy."},{"name":"seen","type":"string","description":"Time the log last observed this witness response."}],"typeName":"LogWitness"}],"errorFormat":"log-resource","errorDetails":[],"responseHeaders":[{"name":"Content-Type","value":"application/json","description":"Use the declared media type before choosing a parser."}],"documentationUrl":"https://veil.rip/docs/log-witnesses","supportsBrowserFetch":true,"browserMode":"fetch"}}