Saltar al contenido principal
GET
Leer resultados de declaraciones de la SEC
Usa el token de result_url. El contexto firmado está vinculado al Workspace y cada Run verifica la Key Policy actual. La lectura no crea Runs, llama a proveedores ni reanuda alternativas. Los archivos contienen la salida normalizada completa; los enlaces solo se renuevan dentro de la retención. Get Run mantiene la salida nativa.

Parámetros de consulta

token
string
requerido

Contexto de resultado opaco devuelto en result_url. Consérvalo sin cambios y autentícate con una API Key autorizada para leer todos los Runs indicados.

Required string length: 1 - 16384

Respuesta

Evidencia de la SEC normalizada con identidad exacta de declaración/sección y Runs de origen. Los campos ausentes quedan en null; los objetivos de oferta se distinguen de los importes vendidos y las alegaciones de los resultados. La salida nativa del proveedor permanece en el Run. Las lecturas son gratuitas y no reanudan la ejecución.

Evidencia de la SEC normalizada con identidad exacta de declaración/sección y Runs de origen. Los campos ausentes quedan en null; los objetivos de oferta se distinguen de los importes vendidos y las alegaciones de los resultados. La salida nativa del proveedor permanece en el Run. Las lecturas son gratuitas y no reanudan la ejecución.

id
string
requerido
run_url
string
requerido

Abre este Run en la consola. Requiere pertenecer al Workspace.

provider
string
requerido
Pattern: ^[a-z0-9][a-z0-9-]*$
endpoint
string
requerido
Pattern: ^\/.+$
endpoint_version
integer
requerido
status
enum<string>
requerido

QUEUED o RUNNING: todavía está en curso. COMPLETED: hay una respuesta del proveedor de datos disponible, incluidas las respuestas que no son 2xx. FAILED: consulta failure. STOPPED: detenido antes del dispatch. Consulta charge_usd por separado de status.

Opciones disponibles:
QUEUED,
RUNNING,
COMPLETED,
FAILED,
STOPPED
failure
object | null
requerido

Motivo por el que falló el Run. Solo es distinto de null cuando status es FAILED.

input
object
requerido
output
object
requerido
provider_response
object | null
requerido

Solo es distinto de null cuando status es COMPLETED.

  • Para respuestas 2xx, output contiene JSON nativo del proveedor de datos (con cualquier estructura) o null si el cuerpo está vacío.
  • Para respuestas que no son 2xx, error contiene el cuerpo del error del proveedor de datos y output es null.

Los campos sensibles se eliminan de ambos cuerpos.

charge_usd
string | null
requerido

Cargo histórico total de los Runs enumerados, incluidos los repetidos o leídos. Es null hasta que todos se liquiden. No es gasto nuevo de la solicitud actual; request_charge lo informa por separado. Los fallos también pueden tener cargo.

Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
charge_basis
object | null
requerido

Base del cargo de un único Run, o null para un total de varios Runs. Consulta runs[].charge_basis para cada cargo.

stoppable
boolean
requerido

Indica si actualmente se puede aceptar una solicitud de detención. Esto no garantiza que el Run pueda detenerse antes del dispatch.

stop_requested_at
string<date-time> | null
requerido

Momento en que se solicitó la detención. El Run puede continuar si el dispatch ya había comenzado.

created_at
string<date-time>
requerido

Marca de tiempo UTC ISO-8601

started_at
string<date-time> | null
requerido

Marca de tiempo UTC ISO-8601

completed_at
string<date-time> | null
requerido

Marca de tiempo UTC ISO-8601

task_id
string | null
requerido
metadata
object
requerido

Tus campos de seguimiento almacenados. Úsalos para filtrar Runs. Nunca se envían al proveedor de datos ni afectan al enrutamiento, Price o la idempotencia.

  • Hasta 20 claves: letras minúsculas, dígitos y guiones bajos; deben comenzar por una letra; como máximo 40 caracteres.
  • Valores: cadenas de 1–500 caracteres.
  • user_id: el ID opaco de tu usuario final, nunca su dirección de correo electrónico ni su nombre.
action
enum<string>
requerido
Opciones disponibles:
resolve,
search,
section,
document,
events,
compensation,
board,
audit_fees,
ipo,
private_placements,
enforcement
result_status
enum<string>
requerido
Opciones disponibles:
success,
no_result,
error,
pending
error
object | null
requerido
runs
object[]
requerido
result_url
string
requerido

Ruta de URL autenticada y de solo lectura para consultar este resultado normalizado y el cargo total. Úsala con el origen de la API. No crea Runs ni reanuda el fallback. GET /v1/runs/:id sigue devolviendo el Run nativo e individual.

response_file
object

Salida normalizada de la SEC completa en JSON que reemplaza output. Los enlaces solo se renuevan dentro de los siete días de retención del Run. Los archivos nativos permanecen en Get Run.

review_invitation
object

Aparece como máximo una vez por Run, en la primera entrega de algunos Runs completados. Después de usar este resultado en la tarea, envía una reseña como indica instruction y continúa. Es opcional; nunca afecta al Run ni a su cargo.

request_charge
object

Evidencia de admisión y cargo de la solicitud actual. Conserve created_run_ids durante el trabajo del usuario y cuente cada Run liquidado una sola vez. Cambiar task_id no convierte una repetición idempotente en un Run nuevo. Leer un resultado tiene cargo cero y listas de admisión vacías.