# Claim Tagged Orders

> Perform Claim Tagged Orders through NikoHealth.

Source: [https://genhealth.ai/docs/workflows/integrations/nikohealth/nikohealth_claim_tagged_orders](https://genhealth.ai/docs/workflows/integrations/nikohealth/nikohealth_claim_tagged_orders)

Integration: [NikoHealth](https://genhealth.ai/docs/workflows/integrations/nikohealth.md)

- Handler: `nikohealth_claim_tagged_orders`

- Connection type: `nikohealth`

## Inputs

- `trigger_tag_name` — Trigger Tag Name (text, required)
  Required text value.
- `processing_tag_name` — Processing Tag Name (text, required)
  Required text value.
- `exclude_tag_names` — Exclude Tag Names (expression)
  Optional literal value or workflow expression.
- `exclude_statuses` — Exclude Statuses (expression)
  Optional literal value or workflow expression.
  Default: `["Cancelled"]`
- `include_statuses` — Include Statuses (expression)
  Optional literal value or workflow expression.
- `lookback_hours` — Lookback Hours (number)
  Optional numeric value.
  Default: `720`
- `created_from` — Created From (expression)
  Optional literal value or workflow expression.
- `created_to` — Created To (expression)
  Optional literal value or workflow expression.
- `timezone` — Timezone (text)
  Optional text value.
  Default: `"America/Chicago"`
- `page_size` — Page Size (number)
  Optional numeric value.
  Default: `100`
- `max_pages` — Max Pages (number)
  Optional numeric value.
- `record_limit` — Record Limit (number)
  Optional numeric value.
- `dry_run` — Dry Run (boolean)
  Optional true-or-false value.
  Default: `true`

## Outputs

- `success` — Success
- `error` — Error
- `items` — Items
- `count` — Count
- `claimed_count` — Claimed Count
- `claim_attempted` — Claim Attempted
- `claim_failed_count` — Claim Failed Count
- `claim_failed_order_ids` — Claim Failed Order Ids
- `skipped_stale_count` — Skipped Stale Count
- `verify_failed_count` — Verify Failed Count
- `diagnostics` — Diagnostics

Output schema completeness: `best_effort_declared`

## Safety

- External effect: `write`
- Confirmation recommended: no
- Retry safe: no
- Dry run supported: yes

## Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

### Input schema

```json
{
  "type": "object",
  "required": [
    "trigger_tag_name",
    "processing_tag_name"
  ],
  "properties": {
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "Optional true-or-false value.",
      "x-workflow-field-type": "boolean"
    },
    "timezone": {
      "type": "string",
      "default": "America/Chicago",
      "description": "Optional text value.",
      "x-workflow-field-type": "text"
    },
    "max_pages": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "page_size": {
      "type": "number",
      "default": 100,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "created_to": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "created_from": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "record_limit": {
      "type": "number",
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "lookback_hours": {
      "type": "number",
      "default": 720,
      "description": "Optional numeric value.",
      "x-workflow-field-type": "number"
    },
    "exclude_statuses": {
      "default": [
        "Cancelled"
      ],
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "include_statuses": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "trigger_tag_name": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    },
    "exclude_tag_names": {
      "description": "Optional literal value or workflow expression.",
      "x-workflow-field-type": "expression"
    },
    "processing_tag_name": {
      "type": "string",
      "description": "Required text value.",
      "x-workflow-field-type": "text"
    }
  },
  "additionalProperties": false
}
```

### Output schema

```json
{
  "type": "object",
  "properties": {
    "count": {},
    "error": {},
    "items": {},
    "success": {},
    "diagnostics": {},
    "claimed_count": {},
    "claim_attempted": {},
    "claim_failed_count": {},
    "skipped_stale_count": {},
    "verify_failed_count": {},
    "claim_failed_order_ids": {}
  },
  "additionalProperties": true
}
```