Skip to main content

2. Basic Searches

This section preserves the RFC text for RDAP RIR search, including rirSearch1, ips, autnums, ipSearchResults, autnumSearchResults, relation links, JSON examples, response behavior, reverse search, conformance, and IANA registrations.

Original RFC Text​

2.  Basic Searches

2.1.  Path Segments

   The new resource type path segments for basic search (similar to the
   searches defined in [RFC9082] and [RFC9083]) are:

   'ips':  Used to identify an IP network search using a pattern to
      match one of a set of IP network attributes.

   'autnums':  Used to identify an autonomous system number search using
      a pattern to match one of a set of autonomous system number
      attributes.

   A search pattern matches a value where it equals the string
   representation of the value, or where it is a match for the value in
   accordance with the use of the asterisk ('*', ASCII value 0x2A)
   character for partial string matching as defined in Section 4.1 of
   [RFC9082].  For most searches, '*' may be used to match trailing
   characters only, and may appear in a search only once: see the
   previously mentioned section for a complete definition of the
   relevant behaviour.

   Section 4.1 of [RFC9082] describes the use of a trailing domain label
   suffix in a partial string search.  It is not necessary that servers
   support this type of search pattern for the basic searches defined in
   this document, since those searches do not relate to domain name
   members.

2.2.  IP Network Search

   Syntax:  ips?handle=<handle search pattern>

   Syntax:  ips?name=<name search pattern>

   Searches for IP network (see Section 5.4 of [RFC9083]) information by
   handle are specified using the form:

      ips?handle=XXXX

   XXXX is a search pattern representing an IP network identifier whose
   syntax is specific to the registration provider.  The following URL
   would be used to find information for IP networks with handles
   matching the "NET-199*" pattern:

      https://example.com/rdap/ips?handle=NET-199*

   Searches for IP network (see Section 5.4 of [RFC9083]) information by
   name are specified using the form:

      ips?name=XXXX

   XXXX is a search pattern representing an IP network identifier that
   is assigned to the network registration by the registration holder.
   The following URL would be used to find information for IP networks
   with names matching the "NET-EXAMPLE-*" pattern:

      https://example.com/rdap/ips?name=NET-EXAMPLE-*

2.3.  Autonomous System Number Search

   Syntax:  autnums?handle=<handle search pattern>

   Syntax:  autnums?name=<name search pattern>

   Searches for autonomous system number (see Section 5.5 of [RFC9083])
   information by handle are specified using the form:

      autnums?handle=XXXX

   XXXX is a search pattern representing an autonomous system number
   identifier whose syntax is specific to the registration provider.
   The following URL would be used to find information for autonomous
   system numbers with handles matching the "AS1*" pattern:

      https://example.com/rdap/autnums?handle=AS1*

   Searches for autonomous system number (see Section 5.5 of [RFC9083])
   information by name are specified using the form:

      autnums?name=XXXX

   XXXX is a search pattern representing an autonomous system number
   identifier that is assigned to the autonomous system number
   registration by the registration holder.  The following URL would be
   used to find information for autonomous system numbers with names
   matching the "ASN-EXAMPLE-*" pattern:

      https://example.com/rdap/autnums?name=ASN-EXAMPLE-*