> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kosli.com/llms.txt
> Use this file to discover all available pages before exploring further.
## Submitting Feedback
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:
POST https://docs.kosli.com/feedback
```json
{
"path": "/api-reference/approval/list-approvals",
"feedback": "Description of the issue"
}
```
Only submit feedback when you have something specific and actionable to report.
# List approvals
> List Allowlist records in an organization.
## OpenAPI
````yaml https://app.kosli.com/api/v2/openapi.json get /approvals/{org}/{flow_name}
openapi: 3.1.0
info:
title: Kosli API
summary: The API for communicating with Kosli
description: >
# Authentication
When making requests against Kosli API, you can authenticate your requests
using a bearer token.
Set the bearer token in the request Authorization header to a valid API
key.
API Keys can be personal or for service accounts. Check the [service
accounts
documentation](https://docs.kosli.com/getting_started/service-accounts/) for
details.
## Curl example
```shell
curl -H "Authorization: Bearer <>"
https://app.kosli.com/api/v2/environments/<>
```
version: '2.0'
servers:
- url: https://app.kosli.com/api/v2
description: EU
- url: https://app.us.kosli.com/api/v2
description: US
security:
- HTTPBearer: []
paths:
/approvals/{org}/{flow_name}:
get:
tags:
- Approval
summary: List approvals
description: List Allowlist records in an organization.
operationId: list_approvals_approvals__org___flow_name__get
parameters:
- name: flow_name
in: path
required: true
schema:
type: string
title: Flow Name
- name: org
in: path
required: true
schema:
type: string
title: Org
- name: page
in: query
required: false
schema:
anyOf:
- type: integer
- type: 'null'
description: The page number of response
default: 1
title: Page
description: The page number of response
- name: per_page
in: query
required: false
schema:
anyOf:
- type: integer
- type: 'null'
description: How many results to return per page of response
default: 20
title: Per Page
description: How many results to return per page of response
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ApprovalResponseSHA1'
title: Response 200 List Approvals Approvals Org Flow Name Get
security:
- HTTPBearer: []
- HTTPBasic: []
components:
schemas:
ApprovalResponseSHA1:
properties:
release_number:
type: integer
title: Release Number
description: The approval number
base_artifact:
type: string
title: Base Artifact
description: The base artifact fingerprint
artifact_name:
type: string
title: Artifact Name
description: The name/identifier of the artifact
target_artifact:
type: string
title: Target Artifact
description: The target artifact fingerprint
environment:
anyOf:
- type: string
- type: 'null'
title: Environment
description: Environment the approval is valid for
description:
type: string
title: Description
description: Description for the approval
src_commit_list:
items:
type: string
pattern: ^[a-f0-9]{40}$
type: array
title: Src Commit List
description: List of commits with their artifact fingerprints
created_at:
type: number
title: Created At
description: Timestamp when the approval was created
last_modified_at:
type: number
title: Last Modified At
description: Timestamp when the approval was last modified
state:
type: string
enum:
- APPROVED
- UNAPPROVED
- PENDING
title: State
description: Overall approval state
approvals:
items:
$ref: '#/components/schemas/ApprovalWithTimestamp'
type: array
title: Approvals
description: List of individual approvals
user_data:
anyOf:
- additionalProperties: true
type: object
- items: {}
type: array
- type: 'null'
title: User Data
description: Additional user data
additionalProperties: false
type: object
required:
- release_number
- base_artifact
- artifact_name
- target_artifact
- description
- src_commit_list
- created_at
- last_modified_at
- state
- approvals
title: ApprovalResponseSHA1
description: Get approval list response.
examples:
- approvals:
- approval_url: undefined
approved_by: external://External
comment: ''
state: APPROVED
timestamp: 1756281574.9707942
artifact_name: >-
a.really.long/name/mimicing/docker@sha256:0fcd25440a99c80ac8df15ca3c5df095a791e7b01fbcb2ac60e9994f1c1e8f4d
base_artifact: 5e2ec37f5b16b662e197a7de71173aac545437f5dab6d0ce452f71dd472a77b2
created_at: 1756281574.9707942
description: ''
environment: staging
last_modified_at: 1756281574.9707942
release_number: 1
src_commit_list:
- 2d04c96662d0190af44f1cba91d3c6028d8392bc
- e412ad6f7ea530ee9b83df964a0dde2b477be729
state: APPROVED
target_artifact: 5e2ec37f5b16b662e197a7de71173aac545437f5dab6d0ce452f71dd472a77b2
user_data: {}
ApprovalWithTimestamp:
properties:
state:
type: string
enum:
- APPROVED
- UNAPPROVED
title: State
comment:
type: string
title: Comment
description: Comment for approval
approved_by:
type: string
title: Approved By
description: The user who approved it
approval_url:
type: string
title: Approval Url
description: URL to the source of the approval
timestamp:
type: number
title: Timestamp
description: Unix timestamp of the approval
type: object
required:
- state
- comment
- approved_by
- approval_url
- timestamp
title: ApprovalWithTimestamp
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
````