HashiCorp Nomad website screenshot

HashiCorp Nomad

HashiCorp Nomad is a flexible workload orchestrator that enables organizations to deploy and manage containers, legacy applications, and batch jobs across any infrastructure. The Nomad developer platform provides a comprehensive HTTP API, official SDKs, and tooling for automating job scheduling, cluster management, and service orchestration at scale.

HashiCorp Nomad publishes 19 APIs on the APIs.io network, including ACL API, Agent API, Allocations API, and 16 more. Tagged areas include Workload Orchestration, Container Orchestration, Scheduling, Infrastructure, and DevOps.

The HashiCorp Nomad catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 2 Spectral governance rulesets.

HashiCorp Nomad’s developer surface includes authentication, developer portal, documentation, support, engineering blog, and 9 more developer resources.

57.3/100 strong ▬ flat Agent 36/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
22 APIs
Workload OrchestrationContainer OrchestrationSchedulingInfrastructureDevOps

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 57.3/100 · strong
Contract Quality 19.2 / 25
Developer Ergonomics 7.8 / 20
Commercial Clarity 14.7 / 20
Operational Transparency 4.1 / 13
Governance 5.0 / 12
Discoverability 6.5 / 10
Agent readiness — 36/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/nomad: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 22

Individual APIs this provider publishes, each with its own machine-readable definition.

HashiCorp Nomad Go SDK

The HashiCorp Nomad Go SDK is the official Go client library for interacting with the Nomad HTTP API. It provides a high-level, idiomatic Go interface for managing jobs, allocat...

HashiCorp Nomad Python SDK

The python-nomad library is a Python client for the HashiCorp Nomad HTTP API. It provides Pythonic access to Nomad resources including jobs, nodes, allocations, deployments, eva...

HashiCorp Nomad Java SDK

The Nomad Java SDK is an official Java client library for the HashiCorp Nomad HTTP API. It enables Java and JVM-based applications to interact with Nomad clusters for submitting...

HashiCorp Nomad ACL API

Endpoints for managing Access Control List policies, tokens, and authentication methods.

HashiCorp Nomad Agent API

Endpoints for interacting with the local Nomad agent, including health checks, member listing, and server management.

HashiCorp Nomad Allocations API

Endpoints for querying allocations. An allocation declares that a set of tasks in a job should be run on a particular node.

HashiCorp Nomad Deployments API

Endpoints for querying and managing deployments. Deployments track the rolling update of allocations between two versions of a job.

HashiCorp Nomad Evaluations API

Endpoints for querying evaluations. Evaluations are the mechanism by which Nomad makes scheduling decisions.

HashiCorp Nomad Jobs API

Endpoints for listing, creating, reading, updating, and deleting jobs. Jobs are the primary unit of work in Nomad.

HashiCorp Nomad Namespaces API

Endpoints for managing namespaces, which segment jobs and their associated objects.

HashiCorp Nomad Node Pools API

Endpoints for managing node pools, which group nodes for scheduling constraints.

HashiCorp Nomad Nodes API

Endpoints for querying and managing client nodes registered with the Nomad cluster.

HashiCorp Nomad Operator API

Endpoints for cluster-level operations such as Raft peer management and autopilot configuration.

HashiCorp Nomad Regions API

Endpoints for listing known regions in the Nomad cluster.

HashiCorp Nomad Scaling API

Endpoints for querying scaling policies and their status.

HashiCorp Nomad Search API

Endpoints for searching across Nomad objects by prefix or fuzzy match.

HashiCorp Nomad Service API

The Service API from HashiCorp Nomad — 1 operation(s) for service.

HashiCorp Nomad Services API

The Services API from HashiCorp Nomad — 1 operation(s) for services.

HashiCorp Nomad Status API

Endpoints for querying the status of the Nomad cluster including leader and peer information.

HashiCorp Nomad System API

Endpoints for system maintenance operations such as garbage collection and reconciliation.

HashiCorp Nomad Variables API

Endpoints for managing Nomad variables, which store encrypted key-value data.

HashiCorp Nomad Volumes API

Endpoints for managing CSI and host volumes attached to Nomad allocations.

Scroll for all 22

Postman Collections 19

Ready-to-run Postman collections for exercising this provider's APIs.

Scroll for all 19

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

HashiCorp Nomad HTTP API

OPEN COLLECTION

Pricing Plans 1

Published pricing tiers and plan structures.

Nomad Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Nomad Rate Limits

4 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Nomad Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

HashiCorp Nomad Event Stream

The Nomad Event Stream provides a way to subscribe to Job, Allocation, Evaluation, Deployment, Node, Node Pool, and Service changes in near real time. The /v1/event/stream endpo...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Nomad Context

0 classes · 13 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

HashiCorp Nomad API Rules

9 rules · 1 errors 8 warnings

SPECTRAL

HashiCorp Nomad API Rules

6 rules · 5 warnings 1 info

SPECTRAL

JSON Schema 1

Standalone JSON Schema definitions for this provider's data models.

HashiCorp Nomad Job

20 properties

JSON SCHEMA

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Nomad Authentication

apiKey/http · 2 schemes

SECURITY

Nomad Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Nomad Agentic Access

79 operations · 33 acting · 1 human-in-the-loop

79 operations · 33 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 1

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 1

Status, limits, changes, and where to get help

Commercial 2

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: nomad
name: HashiCorp Nomad
description: HashiCorp Nomad is a flexible workload orchestrator that enables organizations to deploy and manage containers,
  legacy applications, and batch jobs across any infrastructure. The Nomad developer platform provides a comprehensive HTTP
  API, official SDKs, and tooling for automating job scheduling, cluster management, and service orchestration at scale.
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/nomad.png
url: https://raw.githubusercontent.com/api-evangelist/nomad/refs/heads/main/apis.yml
created: '2026-03-20'
modified: '2026-05-19'
specificationVersion: '0.19'
tags:
- Workload Orchestration
- Container Orchestration
- Scheduling
- Infrastructure
- DevOps
apis:
- aid: nomad:go-sdk
  name: HashiCorp Nomad Go SDK
  description: The HashiCorp Nomad Go SDK is the official Go client library for interacting with the Nomad HTTP API. It provides
    a high-level, idiomatic Go interface for managing jobs, allocations, nodes, deployments, evaluations, and other Nomad
    resources. The SDK is maintained by HashiCorp as part of the main Nomad repository and is used internally by the Nomad
    CLI itself, making it the most comprehensive and up-to-date client available.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://pkg.go.dev/github.com/hashicorp/nomad/api
  tags:
  - Workload Orchestration
  - Go
  - SDK
  - DevOps
  properties:
  - type: Documentation
    url: https://pkg.go.dev/github.com/hashicorp/nomad/api
- aid: nomad:python-sdk
  name: HashiCorp Nomad Python SDK
  description: The python-nomad library is a Python client for the HashiCorp Nomad HTTP API. It provides Pythonic access to
    Nomad resources including jobs, nodes, allocations, deployments, evaluations, namespaces, and ACL management. The library
    supports configuration via environment variables such as NOMAD_ADDR, NOMAD_TOKEN, and NOMAD_NAMESPACE for consistency
    with the Nomad CLI and other ecosystem tools.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://github.com/jrxFive/python-nomad
  tags:
  - Workload Orchestration
  - Python
  - SDK
  - DevOps
  properties:
  - type: Documentation
    url: https://github.com/jrxFive/python-nomad
- aid: nomad:java-sdk
  name: HashiCorp Nomad Java SDK
  description: The Nomad Java SDK is an official Java client library for the HashiCorp Nomad HTTP API. It enables Java and
    JVM-based applications to interact with Nomad clusters for submitting jobs, querying allocations, managing nodes, and
    performing other orchestration operations. The SDK provides a typed Java interface over the Nomad REST API, making it
    suitable for enterprise applications and microservice architectures running on the JVM.
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://developer.hashicorp.com/nomad/api-docs/libraries-and-sdks
  tags:
  - Workload Orchestration
  - Java
  - SDK
  - DevOps
  properties:
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs/libraries-and-sdks
- aid: nomad:nomad-acl-api
  name: HashiCorp Nomad ACL API
  description: Endpoints for managing Access Control List policies, tokens, and authentication methods.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - ACL
  properties:
  - type: OpenAPI
    url: openapi/nomad-acl-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-agent-api
  name: HashiCorp Nomad Agent API
  description: Endpoints for interacting with the local Nomad agent, including health checks, member listing, and server management.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Agent
  properties:
  - type: OpenAPI
    url: openapi/nomad-agent-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-allocations-api
  name: HashiCorp Nomad Allocations API
  description: Endpoints for querying allocations. An allocation declares that a set of tasks in a job should be run on a
    particular node.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Allocations
  properties:
  - type: OpenAPI
    url: openapi/nomad-allocations-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-deployments-api
  name: HashiCorp Nomad Deployments API
  description: Endpoints for querying and managing deployments. Deployments track the rolling update of allocations between
    two versions of a job.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Deployments
  properties:
  - type: OpenAPI
    url: openapi/nomad-deployments-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-evaluations-api
  name: HashiCorp Nomad Evaluations API
  description: Endpoints for querying evaluations. Evaluations are the mechanism by which Nomad makes scheduling decisions.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Evaluations
  properties:
  - type: OpenAPI
    url: openapi/nomad-evaluations-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-jobs-api
  name: HashiCorp Nomad Jobs API
  description: Endpoints for listing, creating, reading, updating, and deleting jobs. Jobs are the primary unit of work in
    Nomad.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Jobs
  properties:
  - type: OpenAPI
    url: openapi/nomad-jobs-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-namespaces-api
  name: HashiCorp Nomad Namespaces API
  description: Endpoints for managing namespaces, which segment jobs and their associated objects.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Namespaces
  properties:
  - type: OpenAPI
    url: openapi/nomad-namespaces-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-node-pools-api
  name: HashiCorp Nomad Node Pools API
  description: Endpoints for managing node pools, which group nodes for scheduling constraints.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Node Pools
  properties:
  - type: OpenAPI
    url: openapi/nomad-node-pools-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-nodes-api
  name: HashiCorp Nomad Nodes API
  description: Endpoints for querying and managing client nodes registered with the Nomad cluster.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Nodes
  properties:
  - type: OpenAPI
    url: openapi/nomad-nodes-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-operator-api
  name: HashiCorp Nomad Operator API
  description: Endpoints for cluster-level operations such as Raft peer management and autopilot configuration.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Operator
  properties:
  - type: OpenAPI
    url: openapi/nomad-operator-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-regions-api
  name: HashiCorp Nomad Regions API
  description: Endpoints for listing known regions in the Nomad cluster.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Regions
  properties:
  - type: OpenAPI
    url: openapi/nomad-regions-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-scaling-api
  name: HashiCorp Nomad Scaling API
  description: Endpoints for querying scaling policies and their status.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Scaling
  properties:
  - type: OpenAPI
    url: openapi/nomad-scaling-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-search-api
  name: HashiCorp Nomad Search API
  description: Endpoints for searching across Nomad objects by prefix or fuzzy match.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/nomad-search-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-service-api
  name: HashiCorp Nomad Service API
  description: The Service API from HashiCorp Nomad — 1 operation(s) for service.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Service
  properties:
  - type: OpenAPI
    url: openapi/nomad-service-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-services-api
  name: HashiCorp Nomad Services API
  description: The Services API from HashiCorp Nomad — 1 operation(s) for services.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Services
  properties:
  - type: OpenAPI
    url: openapi/nomad-services-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-status-api
  name: HashiCorp Nomad Status API
  description: Endpoints for querying the status of the Nomad cluster including leader and peer information.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Status
  properties:
  - type: OpenAPI
    url: openapi/nomad-status-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-system-api
  name: HashiCorp Nomad System API
  description: Endpoints for system maintenance operations such as garbage collection and reconciliation.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - System
  properties:
  - type: OpenAPI
    url: openapi/nomad-system-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-variables-api
  name: HashiCorp Nomad Variables API
  description: Endpoints for managing Nomad variables, which store encrypted key-value data.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Variables
  properties:
  - type: OpenAPI
    url: openapi/nomad-variables-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
- aid: nomad:nomad-volumes-api
  name: HashiCorp Nomad Volumes API
  description: Endpoints for managing CSI and host volumes attached to Nomad allocations.
  humanURL: https://developer.hashicorp.com/nomad/api-docs
  baseURL: http://localhost:4646
  tags:
  - Volumes
  properties:
  - type: OpenAPI
    url: openapi/nomad-volumes-api-openapi.yml
  - type: Documentation
    url: https://developer.hashicorp.com/nomad/api-docs
  - type: AsyncAPI
    url: asyncapi/nomad-event-stream-asyncapi.yml
  - type: JSONSchema
    url: json-schema/nomad-job-schema.json
common:
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/hashicorp-nomad/overview
- type: AgenticAccess
  url: agentic-access/nomad-agentic-access.yml
- type: DomainSecurity
  url: security/nomad-domain-security.yml
- type: Authentication
  url: authentication/nomad-authentication.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/hashicorp
- type: Portal
  url: https://developer.hashicorp.com/nomad
- type: Documentation
  url: https://developer.hashicorp.com/nomad/docs
- type: Website
  url: https://www.nomadproject.io/
- type: PrivacyPolicy
  url: https://www.hashicorp.com/privacy
- type: TermsOfService
  url: https://www.hashicorp.com/terms-of-service
- type: Support
  url: https://support.hashicorp.com/
- type: Blog
  url: https://www.hashicorp.com/blog
- type: Login
  url: https://portal.cloud.hashicorp.com/sign-in
- type: JSONLD
  url: json-ld/nomad-context.jsonld
maintainers:
- FN: API Evangelist
  url: https://apievangelist.com
  email: info@apievangelist.com