HTTP API documentation : response format help and REST API in general?

Hi,

I am trying to interact with the neo4j database with the HTTP API. Currently the neo4r library only works with the old REST API in Neo4j 3.5, but my databases are 4.*

Questions I have.

  1. The documentation here Result formats - HTTP API is very sparse on the result data structures - e.g. what does the metadata object schema look like? where is this documented?

  2. Is there another preferred way to query neo4j over HTTP instead of this HTTP API? It doesn't seem to be documented as well as the old REST API.

cheers
Matt