{
  "service": "certn",
  "displayName": "Certn",
  "categories": [
    "Security",
    "Productivity"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Key",
      "placeholder": "certn_api_key",
      "description": "Certn API key sent as Authorization: Api-Key. Create and manage API keys in the Client Portal under Settings > Integrations > API Keys, as documented at https://centric-api-docs.certn.co/#authentication.",
      "extraFields": [
        {
          "key": "region",
          "label": "Region",
          "inputType": "text",
          "required": true,
          "secret": false,
          "placeholder": "ca",
          "description": "Certn API region for data domiciling. Use ca, uk, au, or sandbox as documented at https://centric-api-docs.certn.co/#introduction."
        }
      ]
    }
  ],
  "homepageUrl": "https://certn.co",
  "actions": [
    {
      "id": "certn.get_case",
      "service": "certn",
      "name": "get_case",
      "description": "Retrieve one Certn background-check case by UUID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Certn UUID.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Certn UUID lookup parameters."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "case": {
            "anyOf": [
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Certn case object."
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "description": "Certn case details."
      }
    },
    {
      "id": "certn.get_group",
      "service": "certn",
      "name": "get_group",
      "description": "Retrieve one Certn group by UUID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Certn UUID.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Certn UUID lookup parameters."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "group": {
            "anyOf": [
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Certn group object."
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "description": "Certn group details."
      }
    },
    {
      "id": "certn.get_user",
      "service": "certn",
      "name": "get_user",
      "description": "Retrieve one Certn Client Portal user by UUID.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Certn UUID.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Certn UUID lookup parameters."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "user": {
            "anyOf": [
              {
                "type": "object",
                "properties": {},
                "additionalProperties": true,
                "description": "Certn user object."
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "additionalProperties": false,
        "description": "Certn user details."
      }
    },
    {
      "id": "certn.list_cases",
      "service": "certn",
      "name": "list_cases",
      "description": "List Certn background-check cases with pagination and optional filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "One-based page number to request from Certn."
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Number of results to return per page. Certn defaults to 10 and allows at most 100."
          },
          "emailAddress": {
            "type": "string",
            "description": "Filter cases by applicant email address.",
            "format": "email"
          },
          "groupIds": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Certn UUID.",
              "format": "uuid"
            },
            "description": "Filter cases by one or more Certn group UUIDs.",
            "minItems": 1
          },
          "overallStatuses": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "Certn case overall status value."
            },
            "description": "Filter cases by one or more Certn overall status values.",
            "minItems": 1
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "Certn tag value."
            },
            "description": "Filter cases by one or more Certn tag values.",
            "minItems": 1
          },
          "checkTypes": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "Certn versioned check type identifier."
            },
            "description": "Filter cases by one or more Certn versioned check type identifiers.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "description": "Filters and pagination for listing Certn cases."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "cases": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "Certn case object."
            },
            "description": "Certn cases returned by the API."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "result_count": {
                "type": "integer",
                "description": "Total number of results."
              },
              "page_count": {
                "type": "integer",
                "description": "Total number of pages."
              },
              "page_size": {
                "type": "integer",
                "description": "Number of results per page."
              },
              "current_page": {
                "type": "integer",
                "description": "Current page number."
              },
              "next_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Next page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Previous page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "count": {
                "type": "integer",
                "description": "Total number of results for legacy paginated endpoints."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Next page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Previous page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true,
            "description": "Certn pagination metadata."
          }
        },
        "additionalProperties": false,
        "description": "Paginated Certn cases."
      }
    },
    {
      "id": "certn.list_events",
      "service": "certn",
      "name": "list_events",
      "description": "List historical Certn events with optional incremental cursor filtering.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "One-based page number to request from Certn."
          },
          "lastProcessedEventId": {
            "type": "string",
            "description": "Certn UUID.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Filters and pagination for listing Certn events."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "events": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "Certn event object."
            },
            "description": "Certn events returned by the API."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "result_count": {
                "type": "integer",
                "description": "Total number of results."
              },
              "page_count": {
                "type": "integer",
                "description": "Total number of pages."
              },
              "page_size": {
                "type": "integer",
                "description": "Number of results per page."
              },
              "current_page": {
                "type": "integer",
                "description": "Current page number."
              },
              "next_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Next page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Previous page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "count": {
                "type": "integer",
                "description": "Total number of results for legacy paginated endpoints."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Next page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Previous page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true,
            "description": "Certn pagination metadata."
          }
        },
        "additionalProperties": false,
        "description": "Paginated Certn events."
      }
    },
    {
      "id": "certn.list_groups",
      "service": "certn",
      "name": "list_groups",
      "description": "List Certn groups with pagination and optional filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "One-based page number to request from Certn."
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Number of results to return per page. Certn defaults to 10 and allows at most 100."
          },
          "id": {
            "type": "string",
            "description": "Certn UUID.",
            "format": "uuid"
          },
          "isActive": {
            "type": "boolean",
            "description": "Whether to return active or inactive groups."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Filter groups by name."
          },
          "parentId": {
            "type": "string",
            "description": "Certn UUID.",
            "format": "uuid"
          }
        },
        "additionalProperties": false,
        "description": "Filters and pagination for listing Certn groups."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "groups": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "Certn group object."
            },
            "description": "Certn groups returned by the API."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "result_count": {
                "type": "integer",
                "description": "Total number of results."
              },
              "page_count": {
                "type": "integer",
                "description": "Total number of pages."
              },
              "page_size": {
                "type": "integer",
                "description": "Number of results per page."
              },
              "current_page": {
                "type": "integer",
                "description": "Current page number."
              },
              "next_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Next page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Previous page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "count": {
                "type": "integer",
                "description": "Total number of results for legacy paginated endpoints."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Next page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Previous page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true,
            "description": "Certn pagination metadata."
          }
        },
        "additionalProperties": false,
        "description": "Paginated Certn groups."
      }
    },
    {
      "id": "certn.list_packages",
      "service": "certn",
      "name": "list_packages",
      "description": "List Certn check packages with pagination and optional filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "One-based page number to request from Certn."
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Number of results to return per page. Certn defaults to 10 and allows at most 100."
          },
          "isActive": {
            "type": "boolean",
            "description": "Whether to return active or inactive packages."
          },
          "permissiblePurposes": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "Certn permissible purpose value."
            },
            "description": "Filter packages by one or more permissible purpose values.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "description": "Filters and pagination for listing Certn packages."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "packages": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "Certn package object."
            },
            "description": "Certn packages returned by the API."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "result_count": {
                "type": "integer",
                "description": "Total number of results."
              },
              "page_count": {
                "type": "integer",
                "description": "Total number of pages."
              },
              "page_size": {
                "type": "integer",
                "description": "Number of results per page."
              },
              "current_page": {
                "type": "integer",
                "description": "Current page number."
              },
              "next_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Next page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Previous page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "count": {
                "type": "integer",
                "description": "Total number of results for legacy paginated endpoints."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Next page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Previous page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true,
            "description": "Certn pagination metadata."
          }
        },
        "additionalProperties": false,
        "description": "Paginated Certn packages."
      }
    },
    {
      "id": "certn.list_questionnaires",
      "service": "certn",
      "name": "list_questionnaires",
      "description": "List Certn questionnaire templates with pagination.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "One-based page number to request from Certn."
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Number of results to return per page. Certn defaults to 10 and allows at most 100."
          }
        },
        "additionalProperties": false,
        "description": "Pagination for listing Certn questionnaire templates."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "questionnaires": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "Certn questionnaire template object."
            },
            "description": "Certn questionnaire templates returned by the API."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "result_count": {
                "type": "integer",
                "description": "Total number of results."
              },
              "page_count": {
                "type": "integer",
                "description": "Total number of pages."
              },
              "page_size": {
                "type": "integer",
                "description": "Number of results per page."
              },
              "current_page": {
                "type": "integer",
                "description": "Current page number."
              },
              "next_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Next page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Previous page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "count": {
                "type": "integer",
                "description": "Total number of results for legacy paginated endpoints."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Next page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Previous page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true,
            "description": "Certn pagination metadata."
          }
        },
        "additionalProperties": false,
        "description": "Paginated Certn questionnaire templates."
      }
    },
    {
      "id": "certn.list_tags",
      "service": "certn",
      "name": "list_tags",
      "description": "List Certn tags with pagination and optional ID filtering.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "One-based page number to request from Certn."
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Number of results to return per page. Certn defaults to 10 and allows at most 100."
          },
          "id": {
            "type": "string",
            "description": "Certn UUID.",
            "format": "uuid"
          },
          "isActive": {
            "type": "boolean",
            "description": "Whether to return active or inactive tags."
          },
          "name": {
            "type": "string",
            "minLength": 1,
            "description": "Filter tags by name."
          }
        },
        "additionalProperties": false,
        "description": "Filters and pagination for listing Certn tags."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "Certn tag object."
            },
            "description": "Certn tags returned by the API."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "result_count": {
                "type": "integer",
                "description": "Total number of results."
              },
              "page_count": {
                "type": "integer",
                "description": "Total number of pages."
              },
              "page_size": {
                "type": "integer",
                "description": "Number of results per page."
              },
              "current_page": {
                "type": "integer",
                "description": "Current page number."
              },
              "next_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Next page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Previous page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "count": {
                "type": "integer",
                "description": "Total number of results for legacy paginated endpoints."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Next page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Previous page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true,
            "description": "Certn pagination metadata."
          }
        },
        "additionalProperties": false,
        "description": "Paginated Certn tags."
      }
    },
    {
      "id": "certn.list_users",
      "service": "certn",
      "name": "list_users",
      "description": "List Certn Client Portal users with pagination and optional filters.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "minimum": 1,
            "description": "One-based page number to request from Certn."
          },
          "pageSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Number of results to return per page. Certn defaults to 10 and allows at most 100."
          },
          "email": {
            "type": "string",
            "description": "Filter users by email address.",
            "format": "email"
          },
          "fullName": {
            "type": "string",
            "minLength": 1,
            "description": "Filter users by full name."
          },
          "groupIds": {
            "type": "array",
            "items": {
              "type": "string",
              "description": "Certn UUID.",
              "format": "uuid"
            },
            "description": "Filter users by one or more Certn group UUIDs.",
            "minItems": 1
          },
          "id": {
            "type": "string",
            "description": "Certn UUID.",
            "format": "uuid"
          },
          "isActive": {
            "type": "boolean",
            "description": "Whether to return active or inactive users."
          },
          "roles": {
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1,
              "description": "Certn role."
            },
            "description": "Filter users by one or more Certn portal roles.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "description": "Filters and pagination for listing Certn users."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "users": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {},
              "additionalProperties": true,
              "description": "Certn user object."
            },
            "description": "Certn users returned by the API."
          },
          "pagination": {
            "type": "object",
            "properties": {
              "result_count": {
                "type": "integer",
                "description": "Total number of results."
              },
              "page_count": {
                "type": "integer",
                "description": "Total number of pages."
              },
              "page_size": {
                "type": "integer",
                "description": "Number of results per page."
              },
              "current_page": {
                "type": "integer",
                "description": "Current page number."
              },
              "next_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Next page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous_page": {
                "anyOf": [
                  {
                    "type": "integer",
                    "description": "Previous page number, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "count": {
                "type": "integer",
                "description": "Total number of results for legacy paginated endpoints."
              },
              "next": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Next page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "previous": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Previous page URL, when available."
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true,
            "description": "Certn pagination metadata."
          }
        },
        "additionalProperties": false,
        "description": "Paginated Certn users."
      }
    }
  ]
}