---
title: "GET /{spaceId}/certificates/{id}/usages"
method: GET
path: "/{spaceId}/certificates/{id}/usages"
tags: ["Certificates"]
---

# GET /{spaceId}/certificates/{id}/usages

`GET /{spaceId}/certificates/{id}/usages`

Get the usages of a certificate

## Path parameters

- `spaceId` string, required
- `id` string, required

## Response `200`

The requested Certificate usages

- CertificateUsageResource
  - `DeploymentTargetUsages` MachineResource[]
    - `Architecture` string
    - `Endpoint` EndpointResource
      - `CommunicationStyle` 'None' | 'TentaclePassive' | 'TentacleActive' | 'Ssh' | 'OfflineDrop' | 'AzureWebApp' | 'Ftp' | 'AzureCloudService' | 'AzureServiceFabricCluster' | 'Kubernetes' | 'StepPackage' | 'KubernetesTentacle' | 'AwsEcsCluster'
      - `Id` string
      - `LastModifiedBy` string
      - `LastModifiedOn` string, date-time
      - `Links` object
    - `EnvironmentIds` string[]
    - `HasLatestCalamari` boolean
    - `HealthStatus` 'Healthy' | 'Unavailable' | 'Unknown' | 'HasWarnings' | 'Unhealthy'
    - `Id` string
    - `IsDisabled` boolean
    - `IsInProcess` boolean
    - `LastModifiedBy` string
    - `LastModifiedOn` string, date-time
    - `Links` object
    - `MachinePolicyId` string
    - `Name` string
    - `OperatingSystem` string
    - `OperatingSystemVersion` string
    - `Roles` string[]
    - `ShellName` string
    - `ShellVersion` string
    - `SkipInitialHealthCheck` boolean
    - `Slug` string
    - `SpaceId` string
    - `StatusSummary` string
    - `TenantedDeploymentParticipation` 'Untenanted' | 'TenantedOrUntenanted' | 'Tenanted'
    - `TenantIds` string[]
    - `TenantTags` string[]
    - `Thumbprint` string
    - `Uri` string
  - `Id` string
  - `LastModifiedBy` string
  - `LastModifiedOn` string, date-time
  - `LibraryVariableSetUsages` LibraryVariableSetResource[]
    - `ContentType` 'Variables' | 'ScriptModule'
    - `Description` string
    - `Id` string
    - `LastModifiedBy` string
    - `LastModifiedOn` string, date-time
    - `Links` object
    - `Name` string
    - `SpaceId` string
    - `Templates` ActionTemplateParameterResource[]
      - `DefaultValue` PropertyValueResource
        - `IsSensitive` boolean
        - `SensitiveValue` SensitiveValue
          - `HasValue` boolean
          - `Hint` string
          - `NewValue` string
        - `Value` string
      - `DisplaySettings` object
      - `HelpText` string
      - `Id` string
      - `Label` string
      - `Name` string
    - `VariableSetId` string
    - `Version` integer
  - `Links` object
  - `ProjectUsages` ProjectResource[]
    - `AllowIgnoreChannelRules` boolean
    - `AutoCreateRelease` boolean
    - `AutoDeployReleaseOverrides` AutoDeployReleaseOverrideResource[]
      - `EnvironmentId` string
      - `ReleaseId` string
      - `TenantId` string
    - `ClonedFromProjectId` string
    - `CombineHealthAndSyncStatusInDashboardLiveStatus` boolean
    - `DefaultGuidedFailureMode` 'EnvironmentDefault' | 'Off' | 'On'
    - `DefaultPowerShellEdition` string
    - `DefaultToSkipIfAlreadyInstalled` boolean
    - `DeploymentChangesTemplate` string
    - `DeploymentProcessId` string
    - `DeprovisioningRunbookId` string
    - `Description` string
    - `DiscreteChannelRelease` boolean
    - `ExecuteDeploymentsOnResilientPipeline` boolean
    - `ExtensionSettings` ExtensionSettingsValues[]
      - `ExtensionId` string
      - `Values` unknown
    - `ForcePackageDownload` boolean
    - `Icon` IconResource
      - `Color` string
      - `Id` string
    - `Id` string
    - `IncludedLibraryVariableSetIds` string[]
    - `IsBadgesEnabled` boolean
    - `IsDisabled` boolean
    - `IsVersionControlled` boolean
    - `LastModifiedBy` string
    - `LastModifiedOn` string, date-time
    - `LifecycleId` string
    - `Links` object
    - `Name` string
    - `PersistenceSettings` PersistenceSettingsResource
      - `Type` 'Database' | 'VersionControlled'
    - `ProjectConnectivityPolicy` DeploymentConnectivityPolicy
      - `AllowDeploymentsToNoTargets` boolean
      - `ExcludeUnhealthyTargets` boolean
      - `SkipMachineBehavior` 'None' | 'SkipUnavailableMachines'
      - `TargetRoles` string[]
    - `ProjectGroupId` string
    - `ProjectTags` string[]
    - `ProjectTemplateDetails` ProjectTemplateDetailsResource
      - `IsShared` boolean
      - `Slug` string, required
      - `VersionMask` string, required
    - `ProvisioningRunbookId` string
    - `ReleaseCreationStrategy` ReleaseCreationStrategyResource
      - `ChannelId` string
      - `ReleaseCreationPackage` DeploymentActionPackageResource
        - `DeploymentAction` string
        - `PackageReference` string
    - `ReleaseNotesTemplate` string
    - `Slug` string
    - `SpaceId` string
    - `Templates` ActionTemplateParameterResource[]
      - `DefaultValue` PropertyValueResource
        - `IsSensitive` boolean
        - `SensitiveValue` SensitiveValue
          - `HasValue` boolean
          - `Hint` string
          - `NewValue` string
        - `Value` string
      - `DisplaySettings` object
      - `HelpText` string
      - `Id` string
      - `Label` string
      - `Name` string
    - `TenantedDeploymentMode` 'Untenanted' | 'TenantedOrUntenanted' | 'Tenanted'
    - `VariableSetId` string
    - `VersioningStrategy` VersioningStrategyResource
      - `DonorPackage` DeploymentActionPackageResource
        - `DeploymentAction` string
        - `PackageReference` string
      - `Template` string
  - `TenantUsages` TenantResource[]
    - `ClonedFromTenantId` string
    - `CustomFields` string[]
    - `Description` string
    - `Icon` IconResource
      - `Color` string
      - `Id` string
    - `Id` string
    - `IsDisabled` boolean
    - `LastModifiedBy` string
    - `LastModifiedOn` string, date-time
    - `Links` object
    - `Name` string
    - `ProjectEnvironments` object
    - `Slug` string
    - `SpaceId` string
    - `TenantTags` string[]

## Other responses

- `400` — Bad request. Either the payload was not structurally valid or business rules did not permit the operation.
- `404` — Not found. One or more of the entities involved in the operation was not found.

---

[API](https://skmtc.net/octopus/apis/octopus-server-api.md) · [All operations](https://skmtc.net/octopus/apis/octopus-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octopus/octopus-server-api/versions/bc9158facfc7/schema)