Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Neo4j Query API

The Neo4j Query API enables the execution of Cypher statements against a Neo4j server through HTTP requests. It provides a streamlined interface for running graph database queries, supporting both self-managed and cloud-hosted Neo4j instances. The Query API is designed for applications that need to interact with Neo4j programmatically and is particularly useful for languages where a dedicated Neo4j driver is not available.

Neo4j Query API is one of 12 APIs that Neo4j publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Graph Database, Cypher, Query, HTTP, and Database. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 1 operation across 1 path, and defines 9 schemas. It is described by OpenAPI 3.1.0, at version 1.0.

Requests are made against a single base URL, https://api.neo4j.io/v1.

1 operations 1 paths 9 schemas 1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0
Server
https://api.neo4j.io/v1
Authentication
HTTP Bearer
Terms of Service
Resource Areas
1

Authentication & Security 1

Neo4j Query API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — OAuth2 bearer token obtained from the /oauth/token endpoint using client credentials. Tokens expire after one hour.

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 POST. Each is listed below with its method, path, parameters, and response codes.

Query 1

Execute Cypher queries using implicit transactions where the server manages transaction lifecycle automatically.

POST
/db/{databaseName}/query
Execute a Cypher query
executeQuery 1 param body → 200400401404

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are QueryStatistics (12 properties), GraphRelationship (5 properties), CypherStatement (4 properties), StatementResult (3 properties). Each schema is shown below with its type and property counts.

QueryStatistics
object
Statistics about query execution.
12 properties
GraphRelationship
object
A relationship returned in graph result format.
5 properties
StatementResult
object
Result of a single Cypher statement execution.
3 properties
CypherStatement
object
A single Cypher statement with optional parameters and result format.
4 properties 1 required
ErrorResponse
object
Response containing one or more errors.
2 properties
QueryResponse
object
Response containing query results from an implicit transaction.
2 properties
QueryRequest
object
Request body for executing one or more Cypher statements using an implicit transaction.
1 property 1 required
Neo4jError
object
An error returned by the Neo4j server.
2 properties
GraphNode
object
A node returned in graph result format.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

neo4j-query-api-openapi.yml Raw ↑

Other APIs Neo4j publishes across the network.

Neo4j GraphQL Library
Neo4j Bolt Protocol
Neo4j Python Driver
Neo4j Java Driver
Neo4j JavaScript Driver
Neo4j Authentication API
Neo4j Discovery API
Neo4j Instances API
Neo4j Snapshots API
Neo4j Tenants API
Neo4j Transactions API