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.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/query-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Neo4j HTTP Query API
description: The Neo4j HTTP API allows developers to execute Cypher queries against a Neo4j database through HTTP requests. It supports both implicit transactions, where the API handles transaction management automatically, and explicit transactions, where developers control the full transaction lifecycle including open, commit, and rollback operations. By default the API uses port 7474 for HTTP and port 7473 for HTTPS on self-managed instances.
version: '5.0'
contact:
name: Neo4j Support
url: https://support.neo4j.com
termsOfService: https://neo4j.com/terms/
servers:
- url: http://localhost:7474
description: Self-managed HTTP server
- url: https://localhost:7473
description: Self-managed HTTPS server
security:
- basicAuth: []
tags:
- name: Query
description: Execute Cypher queries using implicit transactions where the server manages transaction lifecycle automatically.
paths:
/db/{databaseName}/query:
post:
operationId: executeQuery
summary: Execute a Cypher query
description: Executes a Cypher query against the specified database using an implicit transaction. The server wraps the submitted Cypher query in a transaction automatically so that if any part of the query fails the database is reverted to its state before the query was executed. Multiple statements can be sent in a single request and the server runs them in sequence.
tags:
- Query
parameters:
- $ref: '#/components/parameters/databaseName'
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/QueryRequest'
responses:
'200':
description: Query executed successfully
content:
application/json:
schema:
$ref: '#/components/schemas/QueryResponse'
'400':
description: Invalid query or request format
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'401':
description: Authentication required
'404':
description: Database not found
components:
schemas:
StatementResult:
type: object
description: Result of a single Cypher statement execution.
properties:
columns:
type: array
description: Column names in the result set
items:
type: string
data:
type: array
description: Array of result rows
items:
type: object
properties:
row:
type: array
description: Row data values
items: {}
meta:
type: array
description: Metadata for each value in the row
items: {}
graph:
type: object
description: Graph representation of the result when requested
properties:
nodes:
type: array
description: Graph nodes in the result
items:
$ref: '#/components/schemas/GraphNode'
relationships:
type: array
description: Graph relationships in the result
items:
$ref: '#/components/schemas/GraphRelationship'
stats:
$ref: '#/components/schemas/QueryStatistics'
GraphRelationship:
type: object
description: A relationship returned in graph result format.
properties:
id:
type: string
description: The internal relationship ID
type:
type: string
description: The relationship type
startNode:
type: string
description: The ID of the start node
endNode:
type: string
description: The ID of the end node
properties:
type: object
description: Key-value properties of the relationship
additionalProperties: true
QueryResponse:
type: object
description: Response containing query results from an implicit transaction.
properties:
results:
type: array
description: Array of result objects corresponding to each executed statement
items:
$ref: '#/components/schemas/StatementResult'
errors:
type: array
description: Array of errors that occurred during execution
items:
$ref: '#/components/schemas/Neo4jError'
GraphNode:
type: object
description: A node returned in graph result format.
properties:
id:
type: string
description: The internal node ID
labels:
type: array
description: Labels assigned to the node
items:
type: string
properties:
type: object
description: Key-value properties of the node
additionalProperties: true
CypherStatement:
type: object
description: A single Cypher statement with optional parameters and result format.
required:
- statement
properties:
statement:
type: string
description: The Cypher query string to execute
example: MATCH (n) RETURN n LIMIT 10
parameters:
type: object
description: Named parameters for the Cypher query. Always use parameters instead of string concatenation to prevent Cypher injection.
additionalProperties: true
example:
name: Alice
age: 30
resultDataContents:
type: array
description: Requested result formats. Possible values include row and graph.
items:
type: string
enum:
- row
- graph
includeStats:
type: boolean
description: Whether to include query execution statistics in the response
default: false
ErrorResponse:
type: object
description: Response containing one or more errors.
properties:
results:
type: array
description: Empty or partial results
items: {}
errors:
type: array
description: Array of errors that occurred
items:
$ref: '#/components/schemas/Neo4jError'
QueryRequest:
type: object
description: Request body for executing one or more Cypher statements using an implicit transaction.
required:
- statements
properties:
statements:
type: array
description: Array of Cypher statements to execute
items:
$ref: '#/components/schemas/CypherStatement'
QueryStatistics:
type: object
description: Statistics about query execution.
properties:
contains_updates:
type: boolean
description: Whether the query modified the database
nodes_created:
type: integer
description: Number of nodes created
nodes_deleted:
type: integer
description: Number of nodes deleted
properties_set:
type: integer
description: Number of properties set
relationships_created:
type: integer
description: Number of relationships created
relationships_deleted:
type: integer
description: Number of relationships deleted
labels_added:
type: integer
description: Number of labels added to nodes
labels_removed:
type: integer
description: Number of labels removed from nodes
indexes_added:
type: integer
description: Number of indexes created
indexes_removed:
type: integer
description: Number of indexes removed
constraints_added:
type: integer
description: Number of constraints created
constraints_removed:
type: integer
description: Number of constraints removed
Neo4jError:
type: object
description: An error returned by the Neo4j server.
properties:
code:
type: string
description: Neo4j error code in the format Neo.ErrorClassification.Category.Title
example: Neo.ClientError.Statement.SyntaxError
message:
type: string
description: Human-readable error message
example: Invalid input 'X'
parameters:
databaseName:
name: databaseName
in: path
required: true
description: The name of the database to execute queries against. Use neo4j for the default database.
schema:
type: string
example: neo4j
securitySchemes:
basicAuth:
type: http
scheme: basic
description: HTTP Basic Authentication using the Neo4j database username and password encoded as a base64 hash.
externalDocs:
description: Neo4j HTTP API Documentation
url: https://neo4j.com/docs/http-api/current/