> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # List file-availability notices from other participants > The GEN0015 notices other SFN participants sent this institution to say a file is available — answering a GEN0014 request, or announcing the file unprompted — keyset-paged newest announced first, each projected verbatim. Unlike every other arriving message on this rail, the sender is another participant rather than the câmara, so it is carried on each row and verified against the certificate that sent the frame. Read-only, and the notice half only: Lerian SILOC records that a file was announced and publishes the fact; fetching the file is a consumer's decision and a separate leg. ## OpenAPI ````yaml /es/openapi/v3-current/siloc.yaml get /api/v1/siloc/file-notices openapi: 3.1.0 info: description: >- OpenAPI 3.1 surface for Lerian SILOC, the participant-side rail connecting the institution to Núclea's SILOC deferred-net interbank settlement. title: Lerian SILOC API version: 1.0.0 servers: - url: https://siloc.sandbox.lerian.net security: [] paths: /api/v1/siloc/file-notices: get: tags: - FileTransfer summary: List file-availability notices from other participants description: >- The GEN0015 notices other SFN participants sent this institution to say a file is available — answering a GEN0014 request, or announcing the file unprompted — keyset-paged newest announced first, each projected verbatim. Unlike every other arriving message on this rail, the sender is another participant rather than the câmara, so it is carried on each row and verified against the certificate that sent the frame. Read-only, and the notice half only: Lerian SILOC records that a file was announced and publishes the fact; fetching the file is a consumer's decision and a separate leg. operationId: listFileNotices parameters: - description: Opaque pagination cursor. explode: false in: query name: cursor schema: description: Opaque pagination cursor. type: string - description: Page size (default 50, max 200). explode: false in: query name: limit schema: default: 50 description: Page size (default 50, max 200). format: int64 maximum: 200 minimum: 1 type: integer - description: >- Narrow the feed to one announcing participant's ISPB. Grammar only: this rail keeps no roster of legitimate announcers, because GEN0015 is participant-to-participant. explode: false in: query name: ispbEmissor schema: description: >- Narrow the feed to one announcing participant's ISPB. Grammar only: this rail keeps no roster of legitimate announcers, because GEN0015 is participant-to-participant. pattern: ^[0-9A-Z]{8}$ type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/NoticeListResponse' description: OK '422': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Unprocessable Entity '500': content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Internal Server Error default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error security: - BearerAuth: [] components: schemas: NoticeListResponse: additionalProperties: false properties: hasMore: description: Whether more notices exist beyond this page. type: boolean items: description: The page of notices (never null; empty when none). items: $ref: '#/components/schemas/NoticeResponse' type: array nextCursor: description: Opaque cursor for the next page; omitted when the feed is exhausted. type: string required: - items - hasMore type: object Detail: additionalProperties: true properties: code: description: >- Stable, machine-readable domain error code scoped to the emitting service (format: -NNNN). type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string upstream: $ref: '#/components/schemas/Upstream' description: >- RFC 9457 extension member: the error a proxied third-party provider reported. Absent unless the emitting service explicitly surfaced one. type: object NoticeResponse: additionalProperties: false properties: announcedAt: description: The sender's OWN announced instant (DtHrPart), verbatim. format: date-time type: string codMsg: description: Always GEN0015 — participante avisa arquivo disponível. type: string fileId: description: >- Identificador Arquivo; omitted when the file is attached to the message's USERMSG segment. type: string fileName: description: Nome Arquivo — the file the sender made available. type: string fileSize: description: >- Tamanho Arquivo in bytes, as the wire string; omitted when the file is attached to the message's USERMSG segment. type: string hash: description: >- Código Hash — the digest to verify the fetched file against, exactly as the sender wrote it (32 to 40 characters; usually a 40-hex SHA-1 or a 32-hex MD5, but the official type guarantees only the width). Omitted when the sender sent none. type: string history: description: Histórico — the sender's own description of the notice. type: string id: description: Notice id. format: uuid type: string ispbDestinatario: description: This institution's ISPB, as the sender addressed it. pattern: ^[0-9A-Z]{8}$ type: string ispbEmissor: description: >- The participant that announced the file. Verified against the certificate that sent the frame. pattern: ^[0-9A-Z]{8}$ type: string movementDate: description: Movement date (DtMovto), YYYY-MM-DD. format: date type: string numCtrlIF: description: The announcing participant's own control number for this notice. type: string numCtrlReqIFOr: description: >- Control number of the GEN0014 request this notice answers; omitted when the file was announced unprompted. type: string nuop: description: >- BCMSG unique operation number of the frame this row was projected from. type: string receivedAt: description: When this rail stored the notice. format: date-time type: string transmissionType: description: >- Tipo Transmissão, as sent. Its admissible values are defined per file in volume V of the Catálogo, so this rail surfaces it uninterpreted. type: string required: - id - codMsg - numCtrlIF - ispbEmissor - ispbDestinatario - transmissionType - fileName - history - announcedAt - movementDate - nuop - receivedAt type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object Upstream: additionalProperties: false properties: code: description: The upstream provider's own error code, verbatim. examples: - E4001 type: string message: description: >- The upstream provider's own error message, verbatim (bounded, never its raw response body). examples: - account not found at provider type: string type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT bearer token issued by the identity provider. scheme: bearer type: http ````