# View All Files

Retrieve all the files

Files can be filtered using any 'one' of the following parameters. 
|parameter | description|
|--- | ---|
| ids | comma separated list of file ids |
| partId | get all the files for a specific part id |
| trailId | provide job id to list all the records that was created/updated during the job run  |

Endpoint: GET /sbom/v1/orgs/{orgId}/files
Version: 1.0
Security: GlobalSession_header_Authorization

## Query parameters:

  - `ids` (string)
    comma separated list of file ids
    Example: "12,34,56"

  - `partId` (integer)
    Identifies a part by ID.
    Example: 411

  - `trailId` (integer)
    jobid that created/modified the record
    Example: 22

  - `offset` (integer)
    page number of the results to fetch, defaults to first page
    Example: 1

  - `limit` (integer)
    results per page (max 100)
    Example: 10

  - `sort` (string)
    sort the data by the given field e.g sort=field. Use this in combination with 'order' query param.
    Example: "id"

  - `order` (string)
    order the results ascending / descending. Use : asc | desc
    Example: "asc"

## Path parameters:

  - `orgId` (integer, required)
    Organization id
    Example: 38808

## Response 200 fields (application/json):

  - `data` (array)
    Example: [{"id":101,"other-fields":"please check the Schema for all the fields returned in this reponse"}]

  - `meta` (object)
    Represents the Meta information that would be contained in each response returned.
    Example: {"limit":100,"offset":1,"total":1000}

  - `meta.limit` (integer)
    Example: 100

  - `meta.offset` (integer)
    Example: 1

  - `meta.total` (integer)
    Example: 1000

## Response 400 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "server is unable to handle the request"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_gateway"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 401 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "server is unable to handle the request"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_gateway"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 403 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "server is unable to handle the request"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_gateway"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 500 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "server is unable to handle the request"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_gateway"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true

## Response 502 fields (application/vnd.goa.error):

  - `fault` (boolean, required)
    Is the error a server-side fault?
    Example: true

  - `id` (string, required)
    ID is a unique identifier for this particular occurrence of the problem.
    Example: "123abc"

  - `message` (string, required)
    Message is a human-readable explanation specific to this occurrence of the problem.
    Example: "server is unable to handle the request"

  - `name` (string, required)
    Name is the name of this class of errors.
    Example: "bad_gateway"

  - `temporary` (boolean, required)
    Is the error temporary?
    Example: true

  - `timeout` (boolean, required)
    Is the error a timeout?
    Example: true