ActCitedByResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/vaquill-ai/main/json-schema/vaquill-ai-act-cited-by-response-schema.json",
  "title": "ActCitedByResponse",
  "x-generated": "2026-10-07",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vaquill-ai-india-openapi.yml#/components/schemas/ActCitedByResponse",
  "properties": {
    "actId": {
      "type": "string",
      "title": "Actid"
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Title"
    },
    "citation": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Citation"
    },
    "citers": {
      "items": {
        "$ref": "#/$defs/CitedByRow"
      },
      "type": "array",
      "title": "Citers"
    },
    "total": {
      "type": "integer",
      "title": "Total",
      "description": "Distinct citing PROVISIONS across all pages, not rows on this page (that is `returned`) and not matching passages. One provision can be stored as many passages, so this is always the smaller of the two."
    },
    "totalIsExact": {
      "type": "boolean",
      "title": "Totalisexact",
      "description": "False when the corpus scan behind `total` hit its ceiling, which makes `total` a floor rather than a count. The ceiling sits above the largest citing set in the corpus, so this is true today."
    },
    "returned": {
      "type": "integer",
      "title": "Returned",
      "description": "Rows in `citers` on THIS page."
    },
    "page": {
      "type": "integer",
      "title": "Page",
      "description": "1-based page this response answers."
    },
    "pageSize": {
      "type": "integer",
      "title": "Pagesize",
      "description": "Rows per page requested."
    },
    "hasMore": {
      "type": "boolean",
      "title": "Hasmore",
      "description": "True when a further page of citing provisions exists."
    },
    "truncated": {
      "type": "boolean",
      "title": "Truncated",
      "description": "DEPRECATED, kept so an existing client does not break. True when `hasMore` is true or `totalIsExact` is false. Read those two instead: this one field cannot tell 'there is a page 2' apart from 'we stopped counting'."
    },
    "matchBasis": {
      "type": "string",
      "title": "Matchbasis",
      "description": "`publisher_title`: edges are matched on the act's title as the publisher wrote it, so treat the result as a floor."
    },
    "note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Note"
    },
    "resolvedFrom": {
      "anyOf": [
        {
          "$ref": "#/$defs/IdentifierResolution"
        },
        {
          "type": "null"
        }
      ],
      "description": "How your act_id or section number was matched, when it did not match exactly as sent. Null when it did."
    },
    "meta": {
      "$ref": "#/$defs/Meta"
    }
  },
  "type": "object",
  "required": [
    "actId",
    "total",
    "totalIsExact",
    "returned",
    "page",
    "pageSize",
    "hasMore",
    "truncated",
    "matchBasis",
    "meta"
  ],
  "$defs": {
    "CitedByRow": {
      "properties": {
        "actId": {
          "type": "string",
          "title": "Actid"
        },
        "title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Title"
        },
        "citation": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Citation"
        },
        "sectionNumber": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sectionnumber"
        },
        "sectionTitle": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sectiontitle"
        }
      },
      "type": "object",
      "required": [
        "actId"
      ],
      "title": "CitedByRow"
    },
    "IdentifierResolution": {
      "properties": {
        "input": {
          "type": "string",
          "title": "Input",
          "description": "The act identifier exactly as you sent it."
        },
        "actId": {
          "type": "string",
          "title": "Actid",
          "description": "The act_id it matched. Send this next time."
        },
        "sectionInput": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sectioninput",
          "description": "The section number exactly as you sent it, on a section route."
        },
        "sectionNumber": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sectionnumber",
          "description": "The section number as the publisher writes it. Send this next time."
        },
        "via": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Via",
          "description": "What was done to your input, in order. `normalized_id`: the act_id carried surrounding whitespace, quotes, backticks, an invisible character, a trailing period or double percent-encoding, which were removed. `normalized_section`: the section number was written differently from the publisher (a `s.` / `Sec.` / `Section` prefix, a hyphen or space before an alphabetic suffix, a lowercase suffix, or a trailing sub-provision), and matched one stored number and only one."
        },
        "subProvision": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Subprovision",
          "description": "The sub-provision your section number carried, e.g. `(1)(a)` for `302(1)(a)`. The WHOLE section is served: sub-provisions are not addressed separately."
        }
      },
      "type": "object",
      "required": [
        "input",
        "actId"
      ],
      "title": "IdentifierResolution",
      "description": "How the act_id or section number you sent was matched, when not as sent.\n\nPresent only when the input did NOT match exactly. Absent (null) means the\nresponse is about exactly the act_id and section number in your request.\nSame idea, and the same field name, as `resolvedFrom` on the US surface."
    },
    "Meta": {
      "properties": {
        "processingTimeMs": {
          "type": "number",
          "title": "Processingtimems",
          "description": "Server-side time for this request in milliseconds, excluding network transit. Not billed on.",
          "default": 0.0
        },
        "creditsConsumed": {
          "type": "number",
          "title": "Creditsconsumed",
          "description": "Credits actually charged. Read this rather than assuming the list price: refunded work bills 0.",
          "default": 0.0
        }
      },
      "type": "object",
      "title": "Meta"
    }
  }
}