The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

USCIS::Case - Perl extensions to check USCIS (United States Citizenship and Immigration Services) case status. More features would be added in the future.

SYNOPSIS

  use Data::Dumper;
  use USCIS::Case qw(check_case_status);

  my $case = 'LIN0000000000';

  # a hash reference is returned
  my $case_status = check_case_status($case);

  print Dumper($case_status);

DESCRIPTION

USCIS::Case is a wrapper to access USCIS (United States Citizenship and Immigration Services) website to get information about USCIS case. It has only one function now which is to check the case status. But more features would be added in the future.

Each function will return a hash reference.

EXPORT

Nothing is exported by default. You can ask for specific subroutines (described below) or ask for all subroutines at once:

    use USCIS::Case qw(check_case_status);
    # or
    use USCIS::Case qw(:all);

SUBROUTINES

check_case_status

Return a hash reference about the USCIS case information. This hash reference includes 5 entries: validity, case_number, case_status, case_detail and uscis_web_rc.

validity: Default value is no. It contains value "yes" or "no". This indicates if the case number can be queried in USCIS website or not.

case_number: The USCIS case number passed to check status.

case_status: Default value is undef. USCIS case status acquired from USCIS website.

case_detail: Default value is undef. Some extra details about the USCIS case.

uscis_web_rc: Default value is an empty string. This entry records USCIS response code / messages. HTTP 200 response code does not mean the USCIS case can be queried. User must use validity to determine if the USCIS case is valid to query or not.

SEE ALSO

You can find documentation for this module with the perldoc command.

    perldoc USCIS::Case

Source Code: https://github.com/meow-watermelon/USCIS-Case

AUTHOR

Hui Li, <herdingcat@yahoo.com>

COPYRIGHT AND LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.