/v1/issuer/automations
API Key
Paginated
List automations
List all credential automations for the authenticated issuer.
Parameters
| Name | Location | Type | Description |
|---|---|---|---|
status
|
query | string |
Filter by status
Values: draft, active, paused, error
|
trigger_mode
|
query | string |
Filter by trigger mode
Values: manual, scheduled, webhook
|
page
|
query | integer | Page number for pagination |
per_page
|
query | integer | Items per page (default: 25, max: 100) |
X-API-Key
*
|
header | string | Issuer API key for authentication |
* Required parameter
Response
Content-Type: application/json
success
boolean
data
array[object]
Array items:
An automated credential issuance policy
id
*
string
Unique identifier (hashid)
Example: abc123xyz
name
*
string
Display name for the automation
Example: Daily Badge Sync
trigger_mode
*
string
How the automation is triggered: - manual: Triggered via API or dashboard - scheduled: Runs on cron schedule - webhook: Triggered via authenticated webhook
Allowed values: "manual", "scheduled", "webhook"
Example: scheduled
status
*
string
Current status: - draft: Not yet activated - active: Ready to run - paused: Temporarily disabled - error: Error state
Allowed values: "draft", "active", "paused", "error"
Example: active
schedule
string
nullable
Cron expression for scheduled mode
Example: 0 0 * * *
data_source_mapping
*
object
The linked data source mapping
id
*
string
Example: badge-credential-mapping
name
*
string
Example: Employee Database → Employee Badge
account_domain
*
object
The domain under which credentials are issued
id
*
string
Example: aEdOjwxyMwQBkxwgZjNG
domain
*
string
Example: acme-corp.com
can_run
*
boolean
Whether the automation can be triggered
Example: true
running
*
boolean
Whether the automation is currently running
last_run
object
nullable
Information about the last run (detail view only)
at
string (date-time)
Example: 2025-01-15T00:00:00Z
record_count
integer
nullable
Example: 150
error
string
nullable
webhook
object
nullable
Webhook configuration (webhook mode only, detail view)
configured
boolean
Whether a webhook token is configured
Example: true
enabled
boolean
Whether webhook triggers are allowed
Example: true
created_at
*
string (date-time)
When the automation was created
Example: 2025-01-01T00:00:00Z
updated_at
*
string (date-time)
When the automation was last updated
Example: 2025-01-15T10:30:00Z
meta
object
current_page
integer
per_page
integer
total_count
integer
total_pages
integer
Code Examples
import os
from aho_sdk import AhoSdk
client = AhoSdk.issuer(api_key=os.environ["AHO_API_KEY"])
result = client.automations.listclient = AhoSdk.issuer(api_key: ENV["AHO_API_KEY"])
result = client.automations.listimport { AhoSdk } from '@aho/sdk';
const client = AhoSdk.issuer({ apiKey: process.env.AHO_API_KEY });
const result = await client.automations.list;curl -X GET 'https://api.aho.com/v1/issuer/automations' \
-H 'X-API-Key: $AHO_API_KEY'Try It
Log in to test this endpoint directly from the documentation.
Log in